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I.  INTRODUCTION 


A.  THE  UBIQUITOUS  SOLAR  CELL 

The  photovoltaic  effect,  upon  which  solar  cells  depend  for  their  operation,  was  first 
reported  by  Becquerel,  in  1839.  He  observed  a  light-dependent  voltage  between  two 
electrodes  immersed  in  an  electrolyte.  The  effect  was  observed  in  the  solid,  selenium,  in 
1876.  Photocells  made  of  selenium  and  cuprous  oxide  were  soon  developed  (Ref.  1:  p.2j. 
Bell  Telephone  Laboratories  began  theoretical  research  on  the  photovoltaic  effect  in  the 
1930's.  During  the  1940  s  experiments  with  silicon  accelerated  development  of  electrical 
devices  utilizing  semiconductors.  In  1954  the  first  practical  solar  cell  was  produced.  The 
major  stumbling  block  in  development  of  this  cell  was  the  production  of  pure  silicon 
crystal  material.  Breakthroughs  by  Czochralski  in  pure  crystal  growing  and  by  Fuller 
and  Ditzenberger  in  high-temperature  vapor  diffusion  to  form  p-n  junctions  brought 
forth  the  necessary  technology  for  successful  semiconductor  devices  [Ref.  2:  p.1.2-1]. 
The  first  cells  were  approximately  3  cm  diameter  circular  wafers,  resulting  from  the 
maximum  diameter  crystal  that  could  be  grown  with  existing  technology.  Conversion 
efficiency  was  on  the  order  of  six  to  ten  percent. 

While  the  solar  cell  was  first  considered  only  for  terrestrial  applications,  the  advan¬ 
tages  of  light  weight,  small  size,  and  planar  design  destined  this  device  to  play  a  major 
role  in  the  operation  of  spacecraft,  and  indeed,  this  application  was  by  far  the  major  use 
of  the  solar  cell  for  over  ten  years. 

Vanguard  I,  launched  on  March  17,  1958,  became  the  first  solar  powered  earth  sat¬ 
ellite.  The  array  consisted  of  six  solar  panels  distributed  around  the  satellite  body,  each 
made  of  18  p-n  2.0  x  0.5  cm  cells.  The  system  provided  less  than  one  watt  of  power,  and 
operated  for  over  six  years  in  orbit  [Ref.  2:  p.1.1-1].  Since  this  austere  beginning,  solar 
cell  arrays  have  been  a  major  source  of  power  for  a  multitude  of  spacecraft  and  provided 
them  with  from  less  than  a  watt  to  tens  of  kilowatts  of  operating  power.  As  the  power 
requirements  and  complexity  of  spacecraft  have  increased,  the  development  of  solar  cell 
technology  has  kept  pace.  New  materials,  dopants,  surface  preparations,  and  hardware 
have  been  developed.  Understanding  of  the  hazards  of  radiation  from  such  sources  as 
the  sun.  Van  Allen  Belts,  and  deep  space  has  prompted  the  introduction  of  new  adhe¬ 
sives,  substrates,  and  coverglass  materials. 
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Throughout  the  1960's  emphasis  was  placed  on  increasing  radiation  resistance  and 
decreasing  array  weight  and  cost.  For  almost  ten  years  little  progress  was  made  in  the 
development  of  more  efficient  solar  cells  [Ref.  2:  p.1.2-1].  In  the  early  1970  s  new  com¬ 
pounds  such  as  Gallium-Arsenide  (GaAs),  an  optimized  contact  gridline  system,  front 
surface  texturing,  and  new  anti-reflective  coatings,  such  as  tantalum  pentoxide  (fa205), 
introduced  new  "high  efficiency"  cells  with  conversion  efficiencies  of  up  to  sixteen  per¬ 
cent  (Ref.  2:  p.  1.2-2].  These  developments,  coupled  with  the  search  for  new  and  better 
energy  sources,  reawakened  the  interest  in  terrestrial  applications  for  the  solar  cell  [Ref. 
1:  p.2).  A  major  concern  in  the  development  of  these  new  cells  and  associated  hardware 
has  been  the  testing  and  analysis  of  these  devices'  performance  after  prolonged  exposure 
to  the  space  environment,  and.  to  a  lesser  extent,  the  earth  environment. 

B.  SOLAR  CELL  POWER 

Solar  cells  are  essentially  large  p-n  diodes,  and.  as  such,  possess  performance  char¬ 
acteristics  that  are  most  readily  expressed  in  three  parameters.  These  three  parameters 
are  short-circuit  current  (Is;).  open-circuit  voltage  (Voc).  and  fill  factor  (FF).  In  the  ideal 
case.  Is.  would  equal  IL,  the  light-generated  current.  Voc  may  be  defined  by : 

Vc-nf  ln(^+h  (1.1) 

where  k  =  Boltzmann's  Constant,  q  =  the  charge  of  an  electron,  T  =  absolute  temper¬ 
ature,  and  I0  represents  the  saturation  current  [Ref.  1:  p.79[.  The  dependence  of  Voc  on 
I0  makes  this  voltage  parameter  also  dependent  upon  the  properties  of  the  semiconduc¬ 
tor  from  which  the  cell  is  manufactured.  I0  may  vary  with  time  for  a  given  material;  the 
result  of  exposure  to  radiation,  age,  heat,  etc..  Likewise,  IL  may  vary  with  light  intensity. 
Fluctuation  of  these  parameters  produces  varying  voltage  values  which  lie  along  a 
characteristic  I-V  curve.  As  current  through  the  diode,  or  cell,  decreases  from  IIC,  voltage 
begins  to  increase,  rapidly,  at  first,  until  IL  approaches  I0.  As  this  occurs,  voltage  across 
the  p-n  junction  rapidly  stabilizes  at  Voc,  as  may  be  seen  in  Figure  I  on  page  3.  This 
effect  produces  the  characteristic  knee  on  an  I-V  curve.  The  operating  point  which 
maximizes  the  output  power  of  the  cell  (vmp  ,  Imp.)  is  found  on  this  knee. 

FF,  a  measure  of  how  "square"  the  output  characteristics  of  the  diode,  or  cel!  are, 
is  defined  by 
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Figure  1.  Typical  p-n  junction  diode  I-V  curve.  Ref.  1:  p.79 


FF  = 


V  I 

mp  *mp. 

^  (V  1  c  r 


(1.2) 


[Ref.  1:  p. SO].  Optimally.  FF  is  a  function  of  only  since  l,c  is  fixed  for  a  given  device. 
The  energy  conversion  efficiency  of  a  solar  cell.  then,  is 

Vrr.r-W  VqcUcFF 

n  Pm  Pin  (1'3) 


where  P,n  is  the  total  incident  light  power  on  the  cell  [Ref.  1:  p.S  1  ].  Maximum  17  occurs 
at  the  maximum  power  point  (Pn,p ).  Common  commercial  cell  efficiencies  are  in  the 
range  of  12  to  16  percent. 

C.  SOLAR  CELL  CALIBRATION 

The  calibration  of  solar  cells  to  produce  "standard"  cells  is  necessary  for  two  rea¬ 
sons.  First,  to  determine  the  absolute  value  of  the  solar  constant  over  the  spectral  re¬ 
sponse  region  of  solar  cells,  and  second,  to  accurately  establish  the  light  intensity  of  solar 
simulators.  Initial  solar  cell  measurements  were  made  outside,  on  a  sunny  day,  with 
volt-ohmmeters.  pencil,  and  paper.  These  "fair  weather"  tests  were  soon  found  inade¬ 
quate  for  the  accuracy  desired  in  analysis  and  deficient  in  their  consideration  of  the  ef¬ 
fects  of  the  atmosphere  on  solar  radiation. 

Solar  cells  and  array  assemblies  designed  for  spacecraft  were  tested  under  laboratory 
conditions,  illuminated  by  incandescent  tungsten  lamps.  However,  it  was  found  that  the 
color  temperature  of  these  lamps,  2 700 - 3 400 K,  were  much  cooler  than  the  sun.  about 


3 


6000K,  at  air-mass-zero  (AMO).  Further,  the  spectral  composition  of  the  sun  was 
markedly  different  from  that  of  the  tungsten  lamps,  which  contained  large  infrared 
components.  It  was  thought  that  water  filters  would  aid  in  alleviating  some  of  these 
spectral  problems,  but  these  created  even  more  problems  and  were  abandoned.  The 
stability  and  reliability  of  tungsten  lamps  outweighed  the  spectral  shortcomings  of  the 
device  through  the  1960's.  Calibration  of  these  lamps  required  closely  controlled  fila¬ 
ment  voltage  to  control  color  temperature,  and  intensity  adjustment  by  comparison  with 
specially  calibrated  solar  cells.  These  cells  were  measured  in  natural  sunlight  with  a 
pyrheliometer,  a  thermopile  designed  specifically  for  measuring  solar  flux.  Lamps  cali¬ 
brated  with  this  scheme  produced  cells  which  were  tested  under  "Standard  Tungsten  Test 
Conditions"  (unfiltered  tungsten  light  of  2800K+50K,  equivalent  to  100  m\V  cm!  solar 
radiation  at  28°C  cell  temperature).  [Ref.  2:  p.l  1.2-1] 

Standard  Tungsten  Test  Conditions  were  based  upon  the  effect  of  natural  sunlight 
on  solar  cells  under  normal,  but  arbitrary  outdoor  conditions.  "Standard"  solar  cells 
were  measured  under  light  at  any  intensity,  and  the  results  extrapolated  to  100  m\V; 
cm2.  Natural  sunlight  intensity  was  measured  with  standard  meteorological  equipment, 
which  suffered  from  some  accuracy  limitations.  Cells  were  measured  in  collimated  sun¬ 
light,  to  eliminate  the  effects  of  sky  background,  or  corrected  by  application  of  a  cor¬ 
rection  factor  based  upon  the  ratio  of  short  circuit  currents  of  a  cell  measured  in 
uncollimated  light  to  those  measured  in  collimated  light.  Such  cal’  crated  cells  were  used 
as  "standard"  calibration  devices  for  laboratory'  tungsten  illuminators.  [Ref.  2:  p.l  1.2-1] 
A  number  of  problems  and  inaccuracies  were  readily  apparent  under  this  system. 
Natural  sunlight  conditions  at  test  sites  varied  in  both  intensity  and  spectral  content  so 
correlation  from  one  day  to  the  next  was  poor.  The  correlation  between  test  sites  was 
worse.  Standard  cell  calibration  was  then  performed  at  the  Smithsonian  Institute  Solar 
Observatory,  near  Los  Angeles,  California,  where  data  on  sunlight  conditions  and 
spectra  had  been  collected  for  twenty-five  years.  The  altitude  of  the  site  is  7516  ft,  ad¬ 
jacent  to  the  Mohave  Desert  and  characterized  by  relatively  clear  skies  and  low  humid¬ 
ities.  After  the  improvement  of  outdoor  illumination  condition  standards,  the  problems 
of  color  temperature  and  tungsten  sources  were  addressed  through  the  use  of  color 
temperature  meters  which  were  used  for  monitoring  light  and  color  temperature  adjust¬ 
ments  in  tungsten  lamp  voltages.  [Ref.  2:  p.l  1.2-1) 

It  was  believed  that  this  calibration  methodology,  more  reproducible  and  accurate 
than  previous  schemes,  was  sufficient  to  achieve  adequate  extrapolation  of  results  to 


AMO  conditions.  However,  in  1961  it  was  discovered  that  efforts  to  improve  solar  cell 
efficiencies  had  significantly  shifted  spectral  response  toward  the  red.  Cells  and  panels 
measured  under  sources  calibrated  against  standard  cells  were  resulting  in  errors  of  15 
to  20  percent  due  to  the  different  spectral  responses  between  standards  and  new  cells. 
Government  and  industry’  began  a  test  method  standardization  program  which  soon 
solved  some  problem  areas  and  defined  others.  New  standard  cells  were  developed  and 
the  A1EE  established  a  committee  which  prepared  specifications  for  measurement  of 
solar  cells  using  simulated  solar  radiation  conditions.  [Ref.  2:  p.11.2-2] 

Attempts  were  made  to  achieve  the  greatest  possible  accuracy  in  solar  simulation 
and  standards  throughout  the  1960's.  High-altitude  balloon  flights  seemed  to  have  the 
highest  accuracy  and  became  the  definitive  light  intensity  standard.  The  development 
of  solar  simulators  also  progressed  rapidly.  However,  the  unavailability  of  space- 
calibrated  cells  to  verify  simulator  performance  degraded  confidence  in  the  accuracy  of 
these  machines.  The  most  widely  used  solar  simulators  for  cell  and  array  testing  since 
the  late  1960's  have  been  the  X-25  series  solar  simulators  developed  by  the  Spectrolab 
Division  of  Textron  Electronics,  Inc..  These  simulators,  and  those  developed  since,  use 
high-power,  high-pressure  Xenon  arc  lamps.  Smaller,  continuously  operating  lamps 
uniformly  illuminate  an  area  up  to  nearly  0.07  m-\  illuminating  single  cells,  while  Large 
Area  Pulsed  Solar  Simulators  (LAPSS),  are  used  to  test  arrays  up  to  5  m2,  permitting  a 
few  milliseconds  of  illumination  by  radiation  closely  matched  to  AMO  conditions.  [Ref. 

2:  p.11.2-1] 

D.  HIGH-ALTITUDE  BALLOON  CALIBRATION 

Solar  cells  do  not  utilize  all  the  energy  available  in  the  conversion  of  light  energy  to 
electricity.  Various  elements  of  the  solar  spectrum  are  absorbed  and  reflected  by  the 
specialized  materials  from  which  solar  cells  are  made.  Great  effort  has  been  expended 
to  produce  solar  simulators  which  simulate  the  intensity  of  the  sun  as  well  as  its  spec¬ 
trum.  Errors  in  either  could  result  in  an  overweight  array  design  for  a  given  application, 
or  a  system  which  would  prematurely  degrade  and  become  power  deficient. 

The  Jet  Propulsion  Laboratory  (JPL)  has  been  producing  calibrated  reference  solar 
cells  through  its  solar  cell  calibration  program  for  over  twenty-four  years.  This  program 
produces  reference  standard  cells,  with  known  I-V  characteristics,  for  the  purpose  of 
calibrating  earth  solar  simulator  intensities.  Solar  cells  are  flown  on  high-altitude  bal¬ 
loons  to  altitudes  of  approximately  120,000  ft  (36,576  m),  where  I-V  parameters,  tem¬ 
perature,  and  other  data  is  collected.  Flights  at  this  altitude  are  estimated  to  be  within 


0.46  percent  of  AMO,  determined  by  comparison  of  the  ratio  of  atmospheric  pressure 
at  altitude  to  that  at  sea  level  computed  with  the  Air  Research  and  Develpment  Com¬ 
mand  (ARDC)  model  of  the  atmosphere.  Helium-filled  balloons  are  flown  so  as  to  reach 
and  remain  at  altitude  from  two  hours  before  solar  noon  until  two  hours  after  solar 
noon.  The  standard  solar  cell  assemblies  are  mounted  on  a  tracking  system  which 
maintains  orientation  with  the  sun.  Data  is  transmitted  to  a  ground  station  during  the 
flight.  Upon  completion  of  tf  2  mission,  a  valve  is  remotely  opened  and  the  balloon  be¬ 
gins  a  controlled  descent.  The  test  array  and  equipment  are  recovered  after  landing. 
This  method  of  data  collection  benefits  from  the  elimination  of  uncertainties  and  inac¬ 
curacies  in  measurements,  and  minimization  of  corrections  which  must  be  made  to  data 
taken  at  lower  altitudes.  Only  two  corrections  are  required  with  the  high-altitude  bal¬ 
loon  method  of  cell  calibration,  one  for  cell  temperature  and  one  for  earth-sun  distance. 
Both  of  these  factors  are  precisely  known.  Once  the  reference  cell  is  placed  in  a  simu¬ 
lator,  intensity  adjustments  must  be  made  to  match  the  simulator  intensity  to  that  ex¬ 
perienced  by  the  cell  at  altitude.  Some  cells  have  been  reflown  on  subsequent  flights  for 
correlation  of  previous  data.  Repeatability  of  within  ±1  percent  was  achieved,  verifying 
the  accuracy  and  validity  of  previous  reference  data.  [Ref.  2:  p.  1 1.3-1] 

Until  1985  there  had  been  some  question  as  to  the  validity  of  balloon-calibrated 
solar  cells.  There  was  still  a  question  as  to  the  effect  atmosphere  above  the  balloon  had 
on  the  solar  radiation  spectrum.  If  this  effect  was  significant,  this  method  of  solar  cell 
calibration  would  not  produce  the  desired  accuracy  in  earth  solar  simulators.  In  the 
summer  of  1985,  cells  flown  on  a  balloon  were  flown  and  tested  on  a  space  shuttle  flight. 
Comparison  of  the  independent  data  from  the  tw'o  methods  correlated  to  within  one 
percent  [Ref.  3:  p.542[.  Thus,  the  high-altitude  balloon  method  has  proven  to  be  an  ac¬ 
curate  method  for  solar  cell  calibration.  However,  as  new  cells  with  new  spectral  char¬ 
acteristics  are  developed,  new  standards  are  required. 

E.  RADIATION 

There  are  a  variety  of  variables  that  affect  the  performance  of  solar  cells  in  the  space 
environment.  Temperature,  time,  material  composition  and  hardening  mechanisms  must 
all  be  considered  in  the  deployment  of  a  solar  array.  However,  the  single  greatest  effect 
on  an  array  in  space  is  radiation,  which  causes  performance  degradation  during  the  life 
of  a  satellite.  Damaging  radiation  is  composed  of  energetic  or  fast  massive  particles. 
Such  particles,  electrons,  protons,  and  neutrons,  inhabit  the  space  environment,  in 
varying  densities,  and  at  various  times.  Some  radiation  is  a  secondary  effect  of  other 
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phenomena,  such  as  Compton  electrons,  produced  by  gamma  rays.  The  Van  Allen  Belts, 
the  Sun.  and  deep  space  are  all  sources  of  radiation.  The  mass,  energy,  and  charge  of 
these  particles,  or  associated  particles,  may  interact  with  or  damage  solar  cells  in  a 
number  of  ways.  The  radiation  phenomena  of  interest  here  are  ionization  and  atomic 
displacement.  [Ref.  4:  p.3-2] 

Ionization  occurs  when  orbital  electrons  are  removed  from  an  atom  or  molecule. 
Radiation  may  affect  solar  cell  materials  by  several  ionization-related  effects.  The 
darkening  of  solar  cell  coverglasses  is  an  example  of  one  of  these  effects.  Ionizing  radi¬ 
ation  excites  orbital  electrons  which,  upon  entering  the  conduction  band,  become 
trapped  by  impurity  atoms,  creating  defect  complexes  within  the  material  [Ref.  4:  p.3-2]. 

A  large  fraction  of  energy  is  lost  when  fast  electrons  or  protons  collide  with  ab¬ 
sorbing  solar  cell  atoms.  Silicon  atoms  are  displaced  from  their  lattice  structure  posi¬ 
tions  by  these  fast  particles,  causing  permanent  degrading  damage.  The  displaced  atoms 
undergo  other  reactions  and  ultimately  form  stable  defects  which  significantly  modify 
equilibrium  carrier  concentrations  and  minority  carrier  lifetimes. [Ref.  4:  p.3-3] 

It  is  possible  to  characterize  solar  cell  damage  in  terms  of  changes  in  minority  dif¬ 
fusion  length.  This  method  has  been  widely  used,  but  there  are  practical  and  fundamen¬ 
tal  limitations  to  this  approach.  Low  energy  protons,  while  causing  considerable 
displacement  damage  within  the  junction  region  of  a  solar  cell,  increasing  I0  and  de¬ 
creasing  Voc,  do  not  change  the  cell  diffusion  length  [Ref.  4:  p.3-18].  In  addition,  accu¬ 
rate  measurement  of  cell  output  parameters  is  much  less  difficult  than  measurement  of 
diffusion  length,  particularly  after  proton  irradiation.  Empirical  analysis  has  shown  that 
Isc  changes  with  a  linear  function  of  the  logarithm  of  the  fluence  [Ref.  4:  p.3-18].  The 
variation  of  solar  cell  Voc  after  irradiation  has  also  been  empirically  related  to  a  loga¬ 
rithmic  function.  Thus,  solar  cell  damage  is  generally  reduced  to  the  quantifiable 
changes  in  I1C,  V0(.,  and  maximum  power. 

The  w'ide  range  of  electron  and  proton  energies  present  in  space  have  necessitated 
a  method  of  describing  the  effects  of  various  types  of  radiation  environment  which  can 
be  reproduced  in  the  laboratory.  Damage  equivalent  radiation  fluence  was  developed 
to  allow  description  of  the  degradation  of  unshielded  silicon  solar  cells  which  had  expe¬ 
rienced  1  MeV  electron  irradiation  under  laboratory'  conditions,  and  reduce  the  effects 
of  the  space  radiation  environment  on  a  shielded  silicon  solar  cell  to  a  damage  equivalent 
fluence  of  I  MeV  electrons  in  the  laboratory  [Ref.  4:  p. 3-24], 
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Much  data  has  been  collected  concerning  the  effects  of  1  MeV  electron  irradiation 
on  solar  cells.  Particle  acceleration,  x  and  gamma  radiation,  etc.  have  been  utilized  and 
carefully  measured  to  define  relative  damage  effectiveness  on  solar  cells  in  an  effort  to 
simulate  with  1  MeV  electron  radiation,  the  state  of  damage  that  would  be  experienced 
in  the  space  environment  by  an  equivalent  fluence.  This  concept  has  also  been  extended 
to  the  effects  of  proton  irradiation,  a  more  complex  problem  [Ref.  4:  p.3-29].  The  de¬ 
gradation  of  solar  cells  irradiated  with  protons  is  more  complex  because  of  the  nonuni¬ 
form  nature  of  the  damage,  particularly  by  those  with  energy  below  3  MeV.  Proton 
damage  is  more  severe  than  that  of  electrons,  but  can  be  normalized  to  the  damage 
produced  by  electrons.  With  this  information,  simulation  of  the  space  environment  has 
been  almost  the  sole  method  through  which  solar  cell  parameter  degradation  is  meas¬ 
ured. 

F.  IN  SITU  TESTING 

Despite  successes  in  simulating  the  space  environment  and  the  modeling  of  space 
radiation,  the  degrading  mechanisms  which  affect  spacecraft  are  still  not  fully  under¬ 
stood.  For  example,  recent  research  at  the  Naval  Research  Laboratory  (NRL)  indicates 
that  radiation  dose  rates  can  have  as  great  or  greater  impact  than  overall  radiation  doses 
on  particular  solar  cell  degradation  processes  [Ref.  5]. 

Rarely  has  the  long  term  process  and  effects  of  space  radiation  been  observed. 
Simulations  on  Earth  are  relatively  short,  and  the  results  analyzed  after  the  fact.  The 
Navigation  Technology  Satellites  1  and  2  (NTS- 1,2),  were  launched  in  support  of  the 
NAVSTAR  Global  Positioning  System  (GPS)  in  1977.  The  GPS  program  was  con¬ 
cerned  with  the  development  of  high-efficiency  solar  cells  sufficiently  radiation  resistant 
to  deliver  adequate  power  throughout  the  mission  lifetime  of  the  GPS  satellites.  Exper¬ 
imental  solar  cell  arrays  were  on  board  NTS-1  and  N'TS-2.  These  arrays  were  composed 
of  Si  and  state-of-the-art  GaAs  solar  cells  which  were  to  be  evaluated  for  performance 
and  radiation  resistance  in  the  space  environment.  Information  collected  during  the 
mission  was  compared  to  pre-launch  data.  It  was  acknowledged  in  this  experiment  that 
in  situ  observation  was  more  valuable  than  simulation  tests  [Ref.  6:  p.  1234).  1-V  meas¬ 
urements  were  taken  on  entire  arrays  and  telemetered  to  a  ground  station.  Individual 
cell  performance  was  not  observed.  This  is  an  important  point  since  the  current  output 
of  a  string  of  cells  is  limited  to  that  of  the  weakest  cell  in  the  string.  Thus,  a  defective 
or  damaged  cell  will  cause  inaccurate  conclusions  based  on  resulting  data. 
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The  Living  Plume  Shield  II  (LI  PS- 1 1  >.  launched  by  the  NRL  in  February.  19S3, 
carried  three  double-sided  soiar  panels  of  Si  and  GaAs  cells.  This  was  a  cooperative 
program  by  the  U.S.  Navy  and  Air  Force  to  build,  test,  and  qualify  a  GaAs  solar  panel 
in  space.  The  GaAs  solar  cells  flown  were  mounted  in  three  parallel  strings  of  100  cells. 
Each  string  was  25  cells  in  series  by  4  cells  in  parallel  [Ref.  7:  p.  1 1  OS].  Figure  2  outlines 
the  satellite  structure  and  the  GaAs  array. 


Figure  2.  LIPS-II  satellite  and  GaAs  solar  cel!  panel.  Ref.  7:  p.  1 1 1 1 

During  the  first  30  days  of  operation  of  the  satellite,  a  7.3  percent  power  loss  was  expe¬ 
rienced.  These  first  30  days  of  operation  were  also  unmonitored  due  to  satellite  orien¬ 
tation  problems.  While  the  loss  has  never  been  explained,  it  is  believed  that  the 
mechanical  failure  of  a  solar  cell  or  contact  was  the  cause  [Ref.  7:  p.1109].  Had  indi¬ 
vidual  cells,  as  well  as  an  array,  been  tested,  the  question  of  this  power  loss  might  have 
been  resolved.  Further,  an  autonomous  data  collection  and  storage  system  might  also 
have  provided  insight  into  that  power  loss. 

Study  of  the  effects  of  solar  cell  annealing  as  a  method  of  power  recovery  in  de¬ 
graded  solar  cells  is  an  ongoing  effort.  However,  complete  analysis  of  such  effects  re¬ 
quires  exhaustive  study  due  to  the  wide  variations  possible  in  temperature  and  annealing 
rates,  cell  power  recover}',  recovery  rates,  and  the  effects  these  have  on  the  various  ma¬ 
terials  used  in  solar  cell  technology.  Space  environment  tests  would  aid  in  the  under¬ 
standing  and  exploitation  of  this  effect. 

The  Combined  Release  and  Radiation  Effects  Satellite  (CRRES)  Program  is  de¬ 
signed  to  complete  a  variety  of  experiments,  among  which  are  the  measurement  of  radi¬ 
ation  dose  degradation  effects  in  the  space  environment,  and  the  update  of  static  Earth 


radiation  belt  models  [Ref.  8:  p.  1  ].  A  GaAs  solar  cell  panel  experiment  on  board 
CRRES  will  measure  the  performance  characteristics  of  differently  configured  solar  cell 
strings  and  simultaneously  measure  radiation  species  (protons,  electrons,  ions),  their  flux 
levels,  and  energy  distributions.  Annealing  processes  and  optimum  configuration  for 
solar  cell  panels  operating  in  a  high  radiation  environment  will  be  studied  [Ref.  8:  p.43[. 
This  work  will  update  existing  static  radiatmn  belt  models  based  on  data  collected  in  the 
mid  1960's  which  lacked  information  on  ic  \  species,  and  pitch  angles.  This  new  infor¬ 
mation  will  also  provide  the  basis  for  the  first  dynamic  radiation  belt  models  [Ref.  S: 
p.6].  Information  collected  will  be  used  to  optimize  solar  cell  pane]  design  criteria  in 
consonance  with  space  radiation  measurements  [Ref  8  :  p.45].  This  emphasis  on  in  situ 
testing  and  data  collection  is  an  indicator  of  the  importance  of  this  kind  of  information 
to  satellite  designers  and  users. 

Another  application  of  in  situ  solar  cell  and  array  data  is  in  the  monitoring  of  Pmp 
This  is  the  designed  operating  point  of  a  solar  array.  During  the  life  of  a  spaceborne 
array  Pmp  will  shift,  robbing  the  satellite  of  the  maximum  possible  power  available  from 
its  solar  array.  Monitoring  solar  cel!  performance  would  provide  the  opportunity  for 
operational  adjustment  of  the  power  system  on  a  spacecraft,  and  more  efficiently  utilize 
the  remaining  power  production  capabilities  of  the  system. 

G.  THE  MICROPROCESSOR-BASED  TEST  SYSTEM 

Previously,  the  testing,  data  collection,  data  storage,  and  telemetry  of  data  from  a 
spacecraft  to  a  ground  station  posed  numerous  problems.  The  weight  and  complexity 
of  required  testing  devices  was  limiting.  Data  storage  and  handling  equipment  was 
bulky.  Today,  with  modern  digital  techniques  and  microprocessor  controlled  devices, 
these  problems  have  been  resolved.  Indeed,  the  capability  to  collect  more  and  more 
complex  information  in  space  and  transfer  it  to  Earth  has  grown  by  orders  of  magnitude. 
New  technologies  have  miniaturized  components  to  very  small  weight,  volume,  and 
power  parameters.  The  testing  and  monitoring  of  solar  cells  and  arrays  in  space  is  now 
a  viable  option,  as  has  been  demonstrated  by  programs  such  as  those  listed  above. 
Based  on  a  simple  electronic  circuit,  one  microprocessor-based  solar  cell  array  test  sys¬ 
tem,  for  use  in  the  space  environment,  is  presented  below. 


II.  A  NOVEL  SOLAR  CELL  TEST  DEVICE 

A.  APPLICATION 

Dr.  Sherif  Michael  and  Robert  Callaway  developed  a  simple  circuit  for  the  meas¬ 
urement  of  a  solar  cell  1-V  curve  at  the  Naval  Postgraduate  School  in  Monterey, 
California,  in  1986.  This  photovoltaic  test  circuit  was  designed  to  facilitate  the  auton¬ 
omous  testing  of  individual  solar  cells,  although  configuration  for  strings  of  cells  is  also 
possible.  Information  accumulated  from  a  number  of  cells  would  provide  statistically 
relevant  data  for  accurate  assessment  of  the  behavior  of  an  entire  array.  While  this  ap¬ 
proach  precludes  use  of  the  cells  for  power  supply,  there  are  benefits  to  this  method. 
The  failure  or  degredation  of  a  single  cell,  which  can  invalidate  the  data  from  a  string 
of  cells,  can  be  observed  and  resulting  data  discarded  if  inconsistent  with  the  rest  of  a 
test  array.  Such  information  might  have  provided  some  insight  into  the  degradation 
observed  during  the  first  month  in  ori.it  of  the  LIPS-II  satellite  [Ref.  7:  p.llOS]. 

The  autonomous  operation  of  this  circuit  with  a  controlling  system  and  memory- 
device  would  provide  real-time  data  acquisition,  as  on  the  LIPS  experiments  [Ref.  9: 
p.6SS[.  However,  if  real-time  collection  is  not  possible,  or  undesirable,  data  storage  in 
bubble  memory  or  other  nonvolatile  memory  devices  is  possible.  The  lack  of  a  data  re¬ 
cording  system  created  problems  in  data  handling  and  collection  during  and  after  the 
Solar  Cell  Calibration  Experiment  (SCCE)  carried  out  on  the  space  shuttle  in  1983-4 
[Ref.  10:  p.301  ].  Data  storage  also  allows  collection  of  data  for  extended  periods  of  time, 
such  as  on  the  proposed  CRRES  solar  cell  experiments  [Ref.  8:  p.10]. 

Data  for  entire  I-V  curves  can  be  collected,  opposed  to  a  few  points,  as  on  the  LIPS 
tests,  where  only  seven  data  points  were  collected  per  curve  [Ref.  7:  p.1108].  Since  the 
Pmp.  point  shifts  during  the  life  of  an  array,  monitoring  this  parameter  is  important.  A 
few  points  of  data  will  not  provide  accurate  enough  information  for  analysis  of  such 
deviations.  Parameters  such  as  temperature,  sun  angle,  time  of  day,  etc.,  can  also  be 
stored  with  cell  I-V  data,  simplifying  retrieval  and  correlation  of  environmental  infor¬ 
mation. 

B.  TEST  CIRCUIT  REQUIREMENTS 

There  were  a  number  of  requirements  in  the  development  of  a  low  power,  light¬ 
weight.  inexpensive,  and  accurate  solar  cell  parameter  measurement  scheme  capable  of 
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operating  in  the  space  environment.  Below  are  specifications  developed  for  the  auton¬ 
omous  test  circuit  [Ref.  11:  p.6Sj. 

1.  Minimize  series  resistance  through  current  sinks. 

2.  Ability  to  record  data  accurately. 

3.  Capability  to  sweep  current  through  entire  1-V  curve,  (Voc  to  zero  voltage  at  1JC). 

4.  Capability  to  measure  a  series  of  multiplexed  cells  and  sensors  accurately. 

5.  Internal  resistance  of  multiplexer  CMOS  switches  should  not  affect  measured  data. 

6.  Circuit  must  be  simple  and  small . 

7.  Low  power  and  low  thermal  output. 

8.  Buffer  input  and  output  signals  to  insure  accuracy. 

C.  DESIGN 

The  actual  solar  cell  biasing  circuit  is  composed  of  a  high  gain  (h*)  bipolar  junction 
transistor  (BJT),  (eg.  2N3405,  with  hfe>400),  placed  in  a  common  emitter  configuration 
[Ref.  11:  p.70J.  The  test  solar  cell  is  placed  between  a  5  volt  power  source.  Vps  ,  and  the 
collector  of  the  transistor.  This  voltage  level  was  chosen  to  preclude  the  possibility  of 
saturating  the  transistor  in  the  circuit.  A  lower  voltage  would  not  ensure  this.  A  resistor 
is  placed  between  emitter  and  ground.  An  operational  amplifier,  in  a  unity  gain  config¬ 
uration,  utilizes  its  high  input  impedence  to  buffer  and  prevent  undesirable  current- 
produced  effects  in  resulting  test  circuit  data.  Figure  3  on  page  13  depicts  this  circuit 
[Ref.  11:  p.  71], 


Figure  3.  Novel  solar  cell  biasing  circuit. 

The  test  cell  provides  a  load  to  the  transistor.  While  very  little  or  no  current,  (Ib), 
is  allowed  to  flow  into  the  base  of  transistor,  collector  current.  (lc).  approximates  emitter 
current,  (It).  In  this  situation,  with  the  cell  illuminated  and  no  voltage  applied  to  the 
base  of  the  transistor,  the  voltage  across  the  solar  cell  is  Voc.  The  difference  between 
Vp!  and  collector  voltage  Vc,  is  the  solar  cell  circuit  voltage: 

V  -  V  =  V 

y  c  ps  '  s 

Emitter  voltage,  V,  ,  divided  by  the  emitter  resistance,  R,  ,  provides  circuit  current,  1„ 
and 

Vt/R,=  le=Is 

Since  there  is  no  appreciable  current  drain,  It  and,  thus,  I,  are  approximately  zero.  This 
provides  one  endpoint  of  the  cell  s  I-V  curve.  As  a  voltage  is  applied  to  the  transistor 
base,  further  forward  biasing  the  device,  Vc  decreases,  and  current  drain  increases,  until 
the  voltage  across  the  solar  cell  drops  to  zero  and  IK  is  reached.  By  stepping  input 
voltages  to  the  transistor  base,  data  points  for  an  entire  curve  may  be  collected  by 
measuring  Vc  and  V..  [Ref.  11:  p.68] 
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A  multiplexed  system  was  tested  with  a  set  of  these  circuits  attached  to  a  counter 
circuit,  which  simulated  microprocessor  control,  and  a  digital-to-ana!og  device.  The 
capability  to  produce  a  large  number  of  data  points  through  the  D  A  converter  resulted 
in  very  accurate  I-V  curves. 
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III.  MICROPROCESSOR  CONTROLLER 
A.  SYSTEM  DESIGN 

Rather  than  design  a  controller  system  from  scratch,  a  search  was  performed  to 
identify  and  acquire  an  operative  controller  that  fulfilled  the  needs  envisioned  in  the  de¬ 
ployment  of  the  solar  cell  measuring  system.  The  system  needed  to  be  capable  of  oper¬ 
ation  in  the  space  environment.  Low  power  consumption,  simplicity,  small  size,  and 
compatibility  with  the  measurement  circuits  were  also  necessary.  Assembly  language 
programming  was  initially  assumed,  due  to  available  supporting  hardware  at  NPS,  but 
this  requirement  was  relaxed  to  allow  for  a  higher  level  language  with  the  addition  of 
new  compilers  to  NPS. 

The  controller  designed  for  operation  of  the  NPS  Autonomous  Space  Shuttle  Pay- 
load  Bay  Launch  Vibro-acoustics  Experiment  was  ultimately  chosen  for  the  solar  cell 
measurement  system.  The  vibro-acoustics  experiment,  an  ongoing  project,  was  designed 
for  flight  in  the  payload  bay  of  a  space  shuttle  to  measure  the  vibration  and  acoustic 
effects  experienced  by  the  space  shuttle  during  the  stresses  of  a  launch.  The  experiment 
requires  a  NASA-approved  autonomous  control  system  to  detect  shuttle  launch,  execute 
a  power-up  sequence,  and  operate  the  experiment.  The  controller  also  monitors  the 
progress  of  the  experiment  and  contains  diagnostics  within  its  software.  By  necessity, 
characteristics  desirable  for  the  solar  cell  measurement  system  were  inherent  in  this  de¬ 
vice.  The  controller  was  well  developed  and  documented,  both  in  hardware  and  in  soft¬ 
ware.  The  microprocessor  system  was  compatible  with  typical  assembly  languages  for 
which  support  at  NPS  was  readily  available.  The  addition  of  a  C'  language  compiler 
and  subsequent  programming  of  the  controller  in  'C'  was  a  further  incentive  in  the  se¬ 
lection  decision.  The  controller  hardware  had  been  developed  for  low  power  consump¬ 
tion,  as  well  as  minimal  size.  The  entire  controller,  including  memory,  was  placed  on  a 
9  x  5.5  inch  board  and  required  a  single  10  volt  power  supply.  An  external  RS-232  cable 
provided  terminal  access  for  diagnostics.  I/O  ports  end  at  44-pin  connectors  for  easy 
attachment  of  external  devices.  The  vibro-acoustics  experiment  also  developed  the  use 
of  bubble  memory  as  a  means  of  nonvolatile  data  storage.  This  capability  was  not 
chosen  for  use  with  the  solar  cell  measurement  project  due  to  cost  and  the  continued 
development  of  this  capability  within  the  vibro-acoustics  project.  However,  bubble 
memory  presents  a  viable  option  for  future  inclusion  as  a  data  storage  device  with  the 
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solar  cell  measurement  system.  A  complete  schematic  diagram  is  included  in  Appendix 
A. 


B.  CONTROLLER  COMPONENTS 

1.  NSC800  Microprocessor 

The  heart  of  the  controller  is  the  National  Semiconductor  XSC800  micro¬ 
processor.  This  device  provides  the  advantages  of  CMOS  construction,  a  small  heating 
coefficient,  and  low  power  consumption.  The  processor  has  the  ability  to  multiplex  the 
address  data  bus.  An  8-bit  machine,  the  NSC800  can  be  operated  in  a  16-bit  address 
format  by  multiplexing  lower  address  lines  (A0-A7),  latching  them  externally,  and  com¬ 
bining  them  with  the  upper  non-multiplexed  address  bus  (A8-A15),  which  creates  an  ef¬ 
fective  address  space  of  64K  [Ref.  12:  p.8).  This  family  of  devices  has  a  number  of 
compatible  peripheral  devices  and  is  capable  of  addressing  multiple  input  output  (1  O) 
devices.  The  microprocessor  supports  the  Z-SO  assembly  language  instruction  set. [Ref. 
13:  p.  17] 

2.  NSC810A  RAM-I/O-Timer 

The  National  Semiconductor  NSC810A  is  a  random  access  memory  (RAM), 
timer,  and  I  O  peripheral  device.  This  is  another  CMOS  machine,  which  incorporates 
1024  bits  of  built-in  static  RAM  in  an  8-bit  format.  The  1.  0  section  has  22  program¬ 
mable  bits  arranged  into  three  programmable  ports.  Port  A,  composed  of  8  bits,  is  ca¬ 
pable  of  basic  I  O  operation,  or  one  of  three  strobed  modes.  Port  B  is  operable  only  in 
a  basic  1  O  mode.  Port  C  can  be  used  for  basic  I/O  or  as  a  handshake  in  conjunction 
with  port  A  operation  as  a  programmable  timer  [Refs.  13:  p.26.  14:  p.  1  ].  Through  indi¬ 
vidual  port  bit  manipulation,  external  devices  may  be  operated.  Designed  for  operation 
with  the  NSC800,  two  of  these  devices  are  utilized  in  the  controller  system. 

3.  IM6402  Universal  Asynchronous  Receiver  Transmitter  (UART) 

The  UART  provides  the  controller  the  ability  to  interface  with  a  terminal, 
which,  in  turn,  allows  troubleshooting  and  diagnostic  operation  of  the  system.  The 
UART  must  also  transmit  parallel  data  from  the  controller  data  bus  to  external  serial 
data  lines.  The  INTERSIL  IM6402  generates  the  clocking  for  transmitter  and  receiver 
operation  for  such  asynchronous  interfacing.  This  UART  is  another  low  power  CMOS 
device.  [Ref.  13:  p.43] 

4.  MM58167  Real  Time  Clock 

The  vibro-acoustics  experiment  required  initiation  of  experiments  at  a  particular 
time.  Power-up  and  power-down  were  also  part  of  a  power  conservation  requirement 


16 


within  the  completely  autonomous  experiment.  The  ability  to  operate  in  this  fashion  is 
also  compatible  with  the  operation  of  the  solar  cell  measurement  system  which  need 
consume  power  only  when  collecting  data,  excepting  memory  devices.  The  clock  fea¬ 
tures  a  four  year  calendar  with  month  to  thousandths  of  a  second  selection.  The  chip 
includes  a  programmable  alarm  circuit  for  power-up  and  power-down  commands.  The 
N1M58167  is  a  CMOS  device  manufactured  by  National  Semiconductor.  [Refs.  13:  p.51, 
15:  p.lj. 

5.  Memory 

a.  EPROM 

Driver  memory  for  the  controller  is  composed  of  standard  CMOS  L'V 
erasable  PROMs.  The  2764  series  EPROM  is  a  low  power,  high  performance  device 
with  good  noise  immunity.  This  memory  chip  has  a  standard  pin  configuration  and  a 
variety  of  versions  for  specialized  applications,  including  wide  operating  temperature 
ranges  [Ref.  16:  p.  1  ].  The  controller  board  has  space  allocated  for  up  to  eight  memory 
chips.  The  current  solar  experiment  configuration  utilizes  five  of  these  spaces  for 
EPROMs,  which  provide  the  operating  code  for  the  controller.  EPROMs  provide  an 
inexpensive  method  for  rapid  software  development  and  experimental  investigation  into 
the  limits  of  controller  operation. 

b.  Bubble  Memory 

A  nonvolatile  memory  was  required  for  data  storage  on  the  vibro-acoustics 
experiment.  A  similar  memory  system  is  also  necessary  for  solar  cell  measurement  data 
storage.  Bubble  memory  provides  a  relatively  low  power,  megabit  capacity  which  is 
nonvolatile,  even  when  power  is  removed,  purposely  or  in  the  event  of  a  failure  [Ref. 
13:  p. 31].  These  features  make  this  format  ideal  for  large  quantities  of  data  and  long 
term  storage,  as  might  be  experienced  during  a  space  mission.  Bubble  memory  charac¬ 
teristics  also  facilitate  the  retrieval  of  data  for  transmission  at  extended  intervals. 
However,  incorporation  of  bubble  memory,  under  development  for  the  vibro-acoustics 
project,  was  eliminated  at  the  current  time  to  p  .elude  any  delays  in  the  solar  cell  project 
which  might  occur  from  this  ongoing  development.  The  expense  of  bubble  memory,  in 
conjunction  with  currently  available  research  funds,  also  precluded  inclusion  as  a  storage 
device  in  this  project. 

c.  RAM 

A  simple  alternative  to  bubble  memory  is  a  battery  powered  static  RAM 
system,  which  may  remain  powered  at  all  times.  This  approach  would  provide  for  an 
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inexpensive  nonvolatile  memory  with  small  weight  and  power  penalties.  The  current 
controller  is  not  configured  for  a  separate  memory  power  circuit.  It  was  decided  to  leave 
this  relatively  simple  modification  for  later  addition  and  concentrate  on  the  data  col¬ 
lection.  storage,  and  retrieval  system  for  the  solar  cell  project.  Thus,  static  RAM, 
standard  8K  word,  8-bit  chips  were  chosen  for  data  storage.  The  6264  machine  is  an 
industry  standard  with  high-speed  and  low  power  characteristics  [Ref.  17:  p.  1  ].  The 
static  RAM  requires  no  refresh  and  dissipates  less  power  than  dynamic  RAM. 
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IV.  SOLAR  CELL  ARRAY  TEST  CIRCUIT 


A.  OVERVIEW 

The  solar  cell  array  test  circuit  was  designed  to  provide  a  bias  on  test  array  solar 
cells  and  collect  the  resulting  information  relating  to  individual  cell  voltage  output  and 
current.  This  required  conversion  of  digital  signals  to  an  analog  form  to  facilitate  bias¬ 
ing  the  transistors  used  in  the  novel  cell  test  circuits.  The  two  signals  tapped  from  each 
solar  cell  were  then  reconverted  to  digital  form  and  passed  to  the  controller  micro¬ 
processor  for  manipulation  and  storage. 

B.  COMPONENTS 

1.  DAC0800  8-bit  Digital-to-Analog  Converter 

The  DAC0S00  is  a  standard,  8-bit  CMOS  digital-to-analog  converter,  which 
provides  low  power  consumption  and  a  100  ns  output  current  settling  time.  It  requires 
little  direction  or  external  control  and  operates  under  a  wide  power  supply  range.  A 
wide  range  of  applications  and  compatability  with  standard  CMOS  and  TTL  devices  also 
made  it  appealing. [Ref.  18:  p.l] 

2.  HI-506A  Analog  Multiplexer 

The  HI-506A  is  a  rugged  analog  multiplexer  with  the  capability  to  automatically 
multiplex  or  demultiplex  analog  signals.  That  is,  it  is  manufactured  with  the  necessary 
internal  switches  so  as  to  be  insensitive  to  signal  flow  direction.  For  this  application  the 
demultiplexing  capability  was  required.  This  component  was  also  designed  for  space  use 
and  has  a  high  electrostatic  discharge  (ESD)  resistance.  [Ref.  19:  p.l] 

3.  ADC0809  A/D  Converter  and  Multiplexer 

The  ADC0809  device  incorporates  an  8  channel  analog  multiplexer,  aiding  in 
the  minimization  of  individual  hardware  devices,  and  allowing  direct  access  to  analog 
signals.  The  analog-to-digital  converter  is  an  8-bit  machine  using  successive  approxi¬ 
mation  for  conversion.  The  converter  requires  no  external  scale  adjustments.  Latched 
address  inputs  and  outputs  also  maximize  ease  of  interface  with  microprocessors.  It  is 
advertised  to  have  no  missing  codes  and  a  total  unadjusted  error  of±  1/2LSB,  important 
considerations  in  the  accuracy  of  the  final  output  values.  A  CMOS  device,  it  also  pro¬ 
vides  high  speed,  accuracy,  minimal  temperature  dependence,  and  low  power  consump¬ 
tion.  [Ref.  20:  p.l] 


C.  DIGITAL-TO- ANALOG  CONVERSION  AND  DEMULTIPLEXING 

The  8-bit  digital  bias  signal  generated  in  the  controller  was  directed  to  the 
DAC0800.  (Figure  4  on  page  21  refers.)  The  input  was  converted  to  positive  current 
output  and  referenced  to  ground.  The  output  current  signal  was  converted  through  an 
L.M741  op-amp  to  a  positive  low  impedance  voltage  output.  This  output  was  then  for¬ 
warded  to  the  HI506A  Analog  Mulitplexer.  Individual  solar  cell  address  information 
was  wired  into  the  multiplexer  from  NSC 8 10-1.  The  received  voltage  signal  was  thus 
routed  to  the  correct  cell  on  the  array. 

D.  ANALOG  TO  DIGITAL  CONVERSION  AND  MULTIPLEXING 

The  desired  analog  voltage  signal  was  actually  the  difference  between  source  voltage 
and  transistor  collector  voltage.  An  LM741,  in  an  instrument  amplifier  configuration, 
was  placed  across  the  biased  solar  cell  to  provide  this  difference  voltage.  The  resulting 
desired  analog  cell  output  voltage  was  then  routed  to  an  ADC0809.  Here,  address  lines 
from  Port  B  of  NSC810-1  facilitated  demultiplexing.  The  signal  was  converted  to  a 
digital  signal  and  passed  to  Port  A  of  NSC810-2,  as  may  be  seen  in  the  solar  cell  array 
test  circuit  schematic  in  Figure  4  on  page  21. 

Current  information  was  tapped  from  the  biasing  transistor's  emitter  lead  in  analog 
voltage  form.  It  may  be  recalled  that  this  voltage  value,  divided  by  the  known  emitter 
resistance  of  10  ohms,  provides  the  desired  current  value.  This  computation  is  accom¬ 
plished  by  software  in  the  microprocessor  after  analog-to-digital  conversion,  prior  to 
retrieval  of  data  from  storage.  In  a  manner  similar  to  that  of  the  voltage  signal  con¬ 
vergence  scheme,  the  current  information  signal  was  directed  through  a  second 
ADC0809  and  the  resulting  digital  data  placed  on  Port  B  of  NSC810-2. 

E.  INTERFACE 

The  two  NSC810  I/O  devices  were  utilized  for  digital  signal  output,  chip  and  data 
control,  and  digital  data  input.  Port  A  of  NSC810-1  was  used  for  bias  signal  output. 
The  stepped  output  signal  provided  a  bias  for  the  solar  cell  novel  test  circuit.  The  lower 
three  bits  of  Port  B  on  NSC810-1  carried  solar  cell  address  information.  The  fourth  and 
fifth  bits  provided  a  'start  convergence'  pulse  for  analog-to-digital  conversion  on  the 
ADC0809  chips.  The  'output  enable'  signal  to  the  ADC0809  devices  were  always  as¬ 
serted.  Signals  output  by  the  NSC810  ports  were  internally  latched,  providing  simplifi¬ 
cation  of  timing  and  allowance  for  the  settling  time  of  signals  before  reading  or 
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Two  of  the  ports  on  the  NSC810-2  were  used  for  test  circuit  data  retrieval.  Port  A 
received  voltage  information,  and  Port  B  current  information.  Two  bits  of  Port  C  were 
utilized  to  record  the  end-of-convergence  signal  from  the  ADC0S09s.  A  clock  signal 
from  the  controller  was  passed  to  the  ADC0S09s  via  a  spare  port  bit  on  the  NSC810-2. 


V.  SOFTWARE 


A.  CONTROLLER  ROUTINES 

The  controller  software  files  below  are  described  in  a  cursor}’  manner.  They  were 
originally  designed  for  another  project  and  modified  for  use  in  this  application.  A  more 
complete  description  and  use  of  the  files  developed  for  the  NPS  vibro-acoustics  project 
is  available  in,  Control  of  an  Experiment  to  Measure  Acoustic  Noise  in  the  Space  Shuttle, 
by  Charles  Cameron  (Ref.  21]. 

The  software  developed  for  the  microprocesser  controller  was  written  to  provide  for 
autonomous  operation  of  the  system.  This  required  a  timer  and  alarm  routine  to  power 
up  and  power  down  the  system.  A  substantial  diagnostics  routine  and  menu  further 
provided  for  ease  in  manipulation  and  testing  of  the  controller.  Some  of  these  features 
were  incorporated  in  the  portions  of  code  utilized  for  the  solar  cell  test  system.  The  'C' 
language  was  chosen  largely  for  its  readability,  opposed  to  assembly  languages.  While 
a  "high  level”  language.  C  provides  the  ability  to  simply  manipulate  individual  bits,  as 
well  as  operate  on  words  and  bytes.  C  is  also  very  portable.  Appendix  B  includes  the 
start-up  and  operating  routines  for  the  microprocessor  controller.  These  files  are,  for  the 
most  part,  modified  versions  of  those  written  by  Cameron  [Ref.  21:  Chapter  4  and  Ap¬ 
pendix  B]. 

Header  files,  designated  by  the  ”.h"  in  the  file  name,  are  used  to  define  and  declare 
variables,  constants,  functions,  routines,  structures,  etc.  which  will  be  utilized  in  the 
overall  program  by  various  modules  of  code.  The  header  files  indicate  where  externally 
defined  code  is  located.  This  is  necessary  for  program  compilation. 

The  header  file  solarcva.h  defines  parameters  necessary  for  start-up  and  operation 
of  the  controller.  Bit  definitions,  TO  assignments,  and  clock  routine  definitions  are 
provided.  Some  of  these  have  been  renamed  or  modified  for  specific  use  in  the  solar  cell 
test  routines,  which  utilize  I  O  in  a  different  manner  than  originally  intended  for  the 
vibro-acoustics  routines.  The  files  solar.h,  initial. h,  convert. h,  global. h,  inout.h,  delay. h. 
newio.h,  and  clock. h  are  all  header  files  which  declare  functions,  variables,  etc.,  used 
within  the  associated  C  file,  which  has  the  same  name  as  the  header  file.  Such  header 
files  must  be  included  with  routines  which  utilize  these  "externally"  defined  parameters. 

C  files,  those  whose  name  are  followed  by  ".c",  are  the  actual  start-up,  operation, 
and  test  routines  compiled  and  executed  by  the  microprocessor.  With  the  exception  of 
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celltest.c,  all  the  .c  files  are  copies  of,  or  modified  versions  of  the  files  written  by 
Cameron  for  the  vibro-acoustics  project  [Ref.  21:  Appendix  B]. 

Initial. c  is  the  initialization  code  for  the  controller.  The  operations  executed  here 
set  I  O  ports,  initialize  functions  and  sequences,  and  start  the  timer  operation.  The 
initialc  file  is  executed  by  solar.c.  The  solar.c  module  provides  monitor  and  keyboard 
interface,  displays  the  version  of  the  routines  used,  and  prints  a  menu  for  routine  oper¬ 
ation,  testing,  and  diagnostics.  The  separate  modules  which  actually  accomplish  these 
actions  are  accessed  by  solar.c.  The  importance  of  header  files  becomes  apparent  here 
as  routines  external  to  this  file  are  required  for  its  execution.  Solar.c  contains  the 
"main"  portion  of  the  program,  the  code  from  which  all  other  routines  are  accessed,  and 
to  which  they  ultimately  return.  The  menu  selections  'Execution'  and  'Data  Memory' 
were  added  for  experiment  execution  and  data  retrieval,  respectively,  in  the  menu  section 
of  code. 

The  convert.c  module  provides  ASCII  to  hexidecimal,  decimal,  or  binary-coded 
decimal  (bed)  conversions,  as  well  as  the  reverse  operations.  This  is  necessary  for  human 
readability  at  the  monitor,  and  keyboard  interface. 

Inout.c  provides  the  actual  data  output  and  execution  of  keyboard  input  commands. 
While  the  functions  in  this  file  are  all  written  in  C,  some  functions  were  more  efficiently 
written  in  assembly  language,  and  hence,  newio.s  includes  the  operations  of  input  and 
output  of  data  to  and  from  I  O  ports.  Note  that  the  .s  indicates  an  assembly  language 
module.  The  start. s  file  is  the  processor  initialization  code  which  is  executed  when  the 
system  is  reset  or  initially  powered  up. 

The  file  global. c  includes  information  necessary  for  the  timer  and  alarm  routines 
defined  in  clock. c.  The  clock.c  file  provides  for  initialization  of  the  clock  and  setting  a 
wakeup  time  via  a  menu  driven  routine.  The  clock  operates  on  a  four  year  cycle  and 
may  be  set  from  months  to  seconds  of  accuracy  and  waketime.  Delay.s  creates  an  "n" 
millisecond  time  delay.  This  delay  was  used  at  various  points  during  software  and 
hardware  interface  to  check  completion  or  execution  of  digital-to-analog  and  analog- 
to-digital  functions  as  well  as  verify  conversion  time.  A  symbol  table  has  been  included 
which  specifies  variable  definitions  and  declarations  within  compiled  routines.  The  table 
also  provides  memory  address  information,  storage  allocation,  and  total  memory  and 
addressing  necessary  for  programming  PROMs. 

Programming  was  done  on  an  IBM-PC  utilizing  MS  DOS.  Compilation  was  ac¬ 
complished  with  the  Uniware  C  Compiler,  produced  by  the  Software  Development  Sys- 


terns  Co.,  of  Downers  Grove.  Illinois.  Completed  programs  were  linked,  assembled,  and 
transferred  to  EPROMs  on  the  same  machine. 


B.  SOLAR  CELL  ARRAY  ROUTINE 

The  solar  cell  array  test  routine,  celltest.c,  was  designed  to  directly  interface  the  test 
circuit  with  the  controller,  input  output  information,  and  manipulate  that  information 
for  storage  and  use.  The  entire  program  is  included  in  Appendix  C. 

Celltest.c  first  defines  the  variables  used  in  the  routine  which  assign  constants  for 
bit  manipulation  during  execution  of  the  program.  ARRAYSZ  defines  the  number  of 
solar  cells  in  the  array.  STOP  and  START  provide  high  and  low  assertion  for  operating 
bits  on  the  ADC0809s.  Variable  declarations  are  also  made  prior  to  entry  into  the  exe¬ 
cutable  code. 

Three  structures,  groupings  of  specific  variables  that  may  be  handled  together  in  a 
particular  format,  are  defined.  The  first,  PORTl_B,  allows  bit  operation  on  an  output 
port  to  assign  the  solar  cell  address  of  interest  and  to  provide  the  'start  convergence' 
pulse  necessary  for  analog-to-digital  conversion  by  the  hardware,  all  via  the  'command' 
operator.  The  second  structure,  C_PORT,  provides  access  to  two  bits  which  must  be 
read  when  the  ADC0S09s  have  completed  the  convergence  cycle.  The  third  structure  is 
called  data_pt.  This  grouping  assigns  two  variables  which  will  hold  information  for  a 
single  data  point.  Each  pair  of  these  points  is  assigned  to  a  cell  in  the  array, 
experiment_data,  which  is  defined  to  allow  memory  space  for  a  maximum  of  256  data 
points  for  each  of  the  eight  cells  included  in  the  array.  Figure  5  on  page  26  follows  the 
flow  of  this  routine. 

Following  these  definitions  and  declarations,  the  executable  portion  of  the  routine 
begins.  It  is  labeled  'execute'.  The  routine  begins  with  a  loop  for  which  each  iteration 
completes  the  testing  of  one  solar  cell.  Following  the  'for'  statement  which  initiates  this 
loop  are  three  statements  which  initialize  a  variable  counter  and  two  comparison  vari¬ 
ables.  After  these  initializations  are  two  statements  which  address  a  particular  solar  cell 
via  the  PORTI_B  structure  through  a  'command'  statement,  and  execute  the  assignment 
by  output  through  port  I  of  XSC810-1,  the  addressing  and  control  output  port. 

A  second  'for'  statement  is  next  executed,  providing  for  the  biasing  voltage  ladder 
and  associated  control,  manipulation,  and  storage  of  resulting  data  for  each  data  point 
created.  There  are  256  voltage  levels,  evenly  distributed  through  a  three  volt  reference 
source,  which  provide  the  steps  in  this  loop.  These  values  are  passed,  one  at  a  time, 
through  the  D  A  converter,  analog  demultiplexer,  buffer  op-amp,  and  to  the  cell  biasing 
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circuit.  Once  the  cell  has  been  biased,  the  start  convergence  pulse,  'strtcn',  is  asserted 
with  START  and  STOP  statements.  A  single  pulse  is  used  to  start  the  convergence  cycle 
of  both  A  D  converters.  When  each  ADC0809  has  completed  convergence  of  its  as¬ 
signed  analog  signal  to  a  digital  signal,  'end  of  convergence'  pulses  are  transmitted  by 
the  analog-to-digital  converters.  These  pulses  are  received  and  latched  by  two  bits  of 
port  C  on  NSC810-2.  A  'while'  construct  waits  until  these  corresponding  bits  have  been 
asserted  before  allowing  execution  to  continue,  thus  assuring  complete  conversion  before 
storage  of  data. 

The  next  'if  statement  checks  for  a  current  value  greater  than  zero  and  deletes  un¬ 
changed  data  values.  This  prevents  unnecessary  storage  of  data  or  storage  while  the 
input  voltage  ladder  overcomes  the  forward  voltage  of  the  biasing  transistor,  and  during 
which,  no  current  flows.  The  voltage  ladder  provides  voltage  that  will  eventually  satu¬ 
rate  the  biasing  transistor  and  cause  a  negative  voltage  measurement.  It  should  be  noted 
that  the  analog-to-digital  conversion  recognizes  only  magnitude  and  not  gender,  pre¬ 
venting  a  simple  search  for  negative  values.  A  succeeding  nested  pair  of  'if  statements 
provides  a  smoothing  effect  on  data  by  deleting  data  which  is  inconsistent  with  the  curve 
as  a  result  of  conversion  or  other  error.  The  I-V  curve  of  interest  need  not  collect  data 
beyond  the  point  where  voltage  has  reached  zero.  At  this  point  the  difference  between 
the  bias  voltage  and  the  solar  cell  output  has  become  zero  and  short  circuit  current  has 
been  achieved.  Thus,  the  succeeding  'if  statement  ends  the  the  input  ladder  by  incre¬ 
menting  the  counter  to  255.  The  two  digital  data,  voltdata  and  currentdata.  are  stored 
in  RAM  at  this  point.  The  storage  statements  reflect  the  fact  that  not  every  step  of  the 
biasing  loop  will  result  in  storage  of  a  data  point;  the  'row'  parameter  only  increments 
when  data  is  stored  into  the  array.  Figure  6  on  page  28  follows  the  flow  of  this  routine. 

The  succeeding  routine,  'retrieve',  is  executed  by  selection  of  the  appropriate  choice 
on  the  controller  menu.  When  called  upon,  this  routine  retrieves  the  stored  data  from 
RAM  by  first  identifying  the  appropriate  cell  number,  entered  via  the  input  terminal. 
This  cell  number  corresponds  to  the  column  in  the  storage  array  which  holds  the  stored 
data.  The  retrieving  loop  is  written  to  stop  retrieval  at  the  end  of  data  in  the  loop. 

Voltage  and  current  data  were  stored  in  hexidecimal  form  to  minimize  storage  allo¬ 
cation  requirements.  Thus,  for  plotting  and  easy  human  interpretation,  the  data  must 
be  converted  to  a  decimal  form.  Data  is  converted  to  floating  decimal  upon  retrieval  and 
appropriate  scaling  factors  applied.  A  one  volt  reference  was  used  in  the  analog-to- 
digital  conversion  of  the  voltage  values.  This  corresponds  to  0.0039  volts  per  step 
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Figure  6.  'Retrieve'  routine  flow  diagram. 

through  the  256  step  ladder  within  the  ADC0809,  the  applied  multiplication  factor  used 
during  the  voltage  conversion  step.  However,  inherent  conversion  error  requires  an 
offset  factor  which  increased  the  multiplication  factor  to  .0040  for  silicon  cells.  A  wider 
range  of  current  values  was  required  because  of  the  different  outputs  produced  by  Si  and 
GaAs  solar  cells.  Thus,  a  larger  reference  voltage  was  required  for  the  ADC0S09  used 
in  converting  the  voltages  which  indicated  current  levels.  The  three  volt  reference  used 
here  corresponded  to  .0117  volts  per  each  of  the  256  steps.  However,  this  value  required 
a  further  division  by  ten  ohms,  to  complete  the  conversion  from  a  voltage  value  to  a 
current  value.  In  order  to  account  for  the  conversion  error  of  this  ADC0S09.  the  factor 
was  changed  to  0.01 16.  The  emitter  resistors  must  also  be  accurately  measured  prior  to 
current  calculations  and  accounted  for  as  well.  Finally,  the  two  decimal  form  values  are 
output  by  the  microprocessor.  These  values,  with  a  third  parameter  unique  to  the  plot¬ 
ting  routines  used  for  data  display,  were  transferred  to  floppy  disk  via  the  Procomm 
interfacing  program.  Header  and  trailer  inputs  were  included  for  convenience  interfacing 
an  existing  plotting  routine  in  another  program. 
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VI.  TEST  AND  RESULTS 


A.  TEST 

Data  output  format  was  a  manipulation  of  hexidecimal  data  into  floating  decimal. 
This  facilitated  interface  with  a  'personal  computer'  in  the  laboratory  and  the  transfer 
of  data  to  another  storage  medium  for  easy  analysis.  Conversion  from  hexidecimal  to 
floating  point  decimal  need  not  be  accomplished  within  the  controller,  but  was  in  this 
case  for  convenience.  Data  was  retrieved  from  the  solar  cell  test  system  via  a  commer¬ 
cial  interface  program.  Both  available  and  versatile,  'Procomm',  developed  by 
Datastorm  Technologies,  Inc.,  was  chosen  for  this  task.  Retrieved  data  was  transferred 
to  floppy  disk  files  and  printed  out  in  graphic  form  via  a  plotting  routine  on  the  solar 
laboratory  computer.  The  plotting  routine  was  part  of  the  program  designed  for  solar 
cell  data  collection,  storage,  and  analysis  using  the  NPS  Solar  Simulator  and  associated 
hardware  developed  by  Don  Gold  [Ref.  22:  Appendix  D]. 

Ideally,  the  solar  cell  array  test  system  was  designed  to  allow  data  collection  from 
an  entire  array  of  cells.  Practically,  the  system  was  limited  by  the  solar  simulator  light 
source  used  at  NPS  with  this  project.  The  illuminated  area  produced  by  the  simulator 
provides  for.  at  most,  a  pair  of  2  cm  square  cells  under  AMO  conditions.  Thus,  data 
collection  was  limited  to  single  cells. 

B.  RESULTS 

Data  collected  with  the  microprocessor-based  system  for  silicon  solar  cells  was 
plotted  and  compared  to  that  produced  by  the  direct  measurement  and  storage  system 
in  place  in  the  NPS  Solar  Laboratory'.  Figure  7  on  page  31  and  Figure  8  on  page  32 
are  of  two  different  2  cm  x  2  cm  silicon  solar  cells  and  show  the  similarities  in  the  results 
of  the  two  methods  of  data  collection.  A  sample  table  of  silicon  data  is  provided  in 
Appendix  D. 

The  results  for  GaAs  solar  cell  comparisons  is  somewhat  different,  apparent  in  Fig¬ 
ure  9  on  page  33.  While  a  small  adjustment  of  approximately  60^  V  was  added  for  offset 
and  resistor  precision  error,  this  adjustment  proved  inappropriate  for  GaAs  cells.  At  this 
point,  the  effects  of  several  types  of  analog-to-digital  conversion  errors  should  be  inves¬ 
tigated  more  closely  in  conjunction  with  the  conversion  process.  These  effects  include 
[Ref.  23:  p.I13.J: 
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1.  Offset  error  values  which  are  within  the  range  equivalent  to  the  LSB  but  have 
shifted  the  range  upwards,  effectively  extending  the  error  range. 

2.  Gain  error  caused  by  an  input  value  that  is  a  fractional  value  of  the  full  scale  range 
(FSR).  resulting  in  a  corresponding  fractional  binary  output.  The  binary  output 
becomes  detached  from  its  analog  input  with  greater  fractional  values  of  FSR. 
Figure  10  on  page  34  portrays  a  relationship  between  practical  and  ideal  transfer 
curves  of  binary  representations  for  fractional  FSR  values. 

3.  Nonlinearity  for  the  range  of  analog  voltages  applied  when  compared  to  the  binary 
codes  product  1.  If  this  error  is  significant,  differential  linearity  may  cause  a  skip 
of  certain  binary  codes,  known  as  "missing  codes". 

Tests  executed  with  the  delay  of  one  or  more  milliseconds  indicated  that  ample  time  was 
allowed  for  complete  convergence,  and  thus,  should  not  be  a  factor  in  the  errors  ob¬ 
served.  Tests  conducted  without  a  delay  on  silicon  cells  produced  no  variations,  com¬ 
pared  to  those  with  the  delay. 
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Figure  7.  Sample  1,  silicon  solar  cell  I-V  curves. 
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VII.  CONCLUSIONS 


The  microprocessor-based  solar  array  I-V  measurement  system  was  built  using  a 
controller  previously  designed  and  tested  at  the  Naval  Postgraduate  School  in  Monterey, 
California.  This  controller's  programming  was  modified,  and  its  I/O  ports  connected  to 
circuitry  specifically  designed  for  this  project.  Digital  biasing  signals  were  demultiplexed 
through  an  addressing  scheme  and  converted  to  analog  voltages.  These  voltages  were 
then  used  to  bias  a  novel  solar  cell  biasing  circuit,  from  which  two  voltage  taps  were  read 
on  each  cell.  Successive  taps,  representing  cell  voltage  and  current  data  points,  were 
multiplexed,  converted  to  digital  values,  and  stored  in  controller  memory;  data  repres¬ 
enting  a  complete  solar  cell  I-V  curve  for  each  cell  in  the  test  array.  Another  pro¬ 
grammed  routine  enabled  retrieval  of  this  data,  manipulated  into  decimal  form  for 
handling  and  analysis. 

The  microprocessor-based  solar  array  parameter  measurement  system  is  a  viable 
method  for  collection,  storage,  and  retrieval  of  I-V  information  and  other  pertinent  data. 
The  system  is  capable  of  accurately  measuring  a  number  of  cells  in  an  AMO  environ¬ 
ment.  Data  may  be  accessed  from  system  memory,  manipulated,  and  analyzed. 

There  are  a  number  of  improvements  and  possible  avenues  of  study  to  pursue  in  the 
further  development  of  this  project. 

1.  A  more  complete  study  of  the  accuracy  of  the  systems  output,  including  the  possi¬ 
bility  of  using  a  16- bit  microprocessor  system. 

I  2.  A  software  or  hardware  approach  for  analysis  and  compensation  for  conversion 

error  effects. 

3.  Installation  of  the  alarm  clock  system  for  timed  power-up  and  power-down. 

4.  The  inclusion  of  nonvolatile  memory;  battery  powered  or  bubble  memory. 
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APPENDIX  B.  CONTROLLER  START-UP  AND  OPERATING  CODE 

A.  FILENAME  SOLAREVA.H 

Hay  4,  1486  solareva.h  »/ 

TRIES  3  /#  Number  of  times  to  try  something  before  giving  up.  */ 

STRLEN  7  /*  Number  of  characters  to  allow  for  integer 

characters*  including  a  null  terminator.  »/ 

HSTRLEN  2  /*  Number  of  characters  to  allow  for  hexadecimal 
characters#/ 

HEXINTSTRLEN  4  /»  Number  of  characters  in  a  hexadecimal  word.  «/ 

DUMPWIDTH  16  /*  Number  of  bytes  in  a  line  of  a  memory  dump.  */ 

TERMON  0x08  /«  Points  to  the  terminal  connection  line  in  NSC810  SI* 

Port  C,  Pin  3.  »/ 


/*  Bit  definitions  for  port  C  of  NSC810  #2.  (Base  address  is  0x22.  ) 


Bit  S 

Meaning 

5 

X 

4 

X 

3 

X 

2 

End  of  Convergence  signal  EOC-2 

1 

End  of  Convergence  signal  EOC-1 

0 

X 

*/ 

Sdef ine 

READC1 

0x02 

/«  Points  to  the  NSC810  #1,  Port  C, 

R/W  register.  #/ 

((define 

BCLRC1 

0x0a 

/*  Points  to  the  NSC810  SI*  Port  C, 

Clear  register.  «/ 

Sdef ine 

BSETC1 

OxOe 

/*  Points  to  the  NSC810  SI,  Port  C, 

Set  register.  »/ 

(tdef  ine 

BCLRC2 

0x2a 

/*  Points  to  the  NSC810  S2,  Port  C, 

Clear  register.  */ 

(tdef  ine 

BSETC2 

0x2e 

/*  Points  to  the  NSC810  S2,  Port  C, 

Set  register.  #/ 

(tdef  ine 

MDR1 

0x07 

/*  See  the  documentation  for  a  description  of  the  «/ 

(tdef  ine 

0DRA1 

0x04 

/#  use  of  these  ports.  */ 

(tdef  ine 

DDRB1 

OxOS 

ltdef  ine 

DDRC1 

0x06 

((define 

TM01 

0x18 

(tdef  ine 

T0LB1 

0x10 

((define 

T0HB1 

0X11 

(tdef  ine 

START01 

0x15 

((define 

MDR2 

0x27 

(tdef  ine 

DDRA2 

0x24 

((define 

0DRB2 

0x25 

((define 

DDRC2 

0x26 

((define 

TM02 

0x38 

(tdef  ine 

TOLBZ 

0x30 

((define 

T0HB2 

0x31 

((define 

STARTOZ 

0x35 

((define 

PRTDATA 

OxcO 

/*  Port  number  for  data  from  RS-232C  interface.  #/ 

((define 

PRTCTRL 

OxeO 

/*  Port  number  for  control  information  from  RS-232C 

/« 

((define 

((define 

((define 

((define 
Sdef ine 

(tdef  ine 
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interface.  »/ 


PRTOUTRDY  0x01 

/* 

Bit  zero  of  the  PRTCTRL  byte  is  a  one  if  the  printer 

is  ready  to  accept  data  and  zero  otherwise. 

«/ 

PRTRDY  0x02 

/» 

Bit  one  of  the  PRTCTRL  byte  is  a  one  if  there 

is 

data  to  be  read  and  zero  otherwise.  */ 

P0RT1_DA 

0x00 

/*  0/A  Output  address  ( port  A  on  NSC810-1 ) 

*/ 

P0RT1_CTRL 

0x01 

/»  D/A  Control  Port  (port  B  on  NSC810-1)  »/ 

PORT  2_ADV 

0x20 

/ft  A/D  Voltage  input  »/ 

PORT 2_ ADC 

0x21 

/»  A/D  Current  irput  »/ 

P0RTC2 

0x22 

/*  A/D  E0C  port  */ 

TRUE  Oxff 

FALSE  0x00 

ASCII  0 

/*  Used  as  a  parameter  to  showbubbuffl  ).  ft/ 

HEX  1 

/ft  Used  as  a  parameter  to  showbubbufft  ).  «/ 

NULL  0x00 

/ft  The  following  are  ASCII  definitions,  ft/ 

BELL  0x07 

SPACE  0x20 

DELETE  0x7f 

THOUSANDTHS 

0x60  /ft  The  ports  for  reading  the  date  and 

time. 

HUNDREDTHS 

0x61 

SECONDS 

0x62 

MINUTES 

0x63 

HOURS 

0x64 

WEEKDAY 

0x65 

DATE 

0x66 

MONTH 

0x67 

struct  datetime  { 


. 

char 

month > 

/ft 

char 

dates 

/« 

char 

hour  i 

/ft 

* 

char 

minutei 

n 

char 

second i 

S 

char 

hundredths l 

t 

• 

char 

thousandths ! 

■ 

struct  idatetime 

< 

/» 

int 

imonth! 

/» 

• 

int 

i da tel 

/* 

int 

ihour ! 

/» 

int 

iminutei 

int 

i second! 

int 

i hundredths! 

i 

int 

i thousandths! 

19 

K  r 


/ft  This  structure  contains  binary  coded  »/ 


*/ 


)! 


clockintl  ) 


takes  care  »/ 
»r  format.  ft/ 


| 
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B.  FILENAME  SOLAR.H 


/*  April  19,  1988  solar. h  */ 

extern  void  version! void ) ) 
ex-tern  void  memory _dump(  void )  ) 
extern  char  menu! void)) 

C.  FILENAME  INITIAL.H 

/*  April  19,  1988  initial. h  */ 
extern  void  inithardware!  void ) ) 

D.  FILENAME  CONVERT.H 

/*  convert. h  April  20,  1988  */ 


extern  char  atohlchar  *ascii)) 

extern  unsigned  int  atohexint! char  asciiM)) 

extern  int  atoilchar  *s)j 

extern  char  *bcd_asc( char  bed)) 

extern  int  bcd_int!char  bed)) 

extern  char  »ctoh(char  byte)) 

extern  char  int_bcdl int  decimal)) 

extern  char  *itoa!int  n,  char  sf ])) 

extern  char  tolowerlchar  c)) 

extern  char  «uitoh( unsigned  int  word)) 

E.  FILENAME  GLOBAL. H 

/*  April  19,  1988  global. h  */ 
extern  char  prtcormected) 
extern  struct  datetime  clock) 
extern  struct  idatetima  waketime) 
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F.  FILENAME  INOUT.H 


/*  April  19,  1988  inout.h  */ 

extern  char  checkprtl void),  gethexl void ) ,  termini  void)) 

extern  int  get  inti  void ) ) 

extern  unsigned  int  gethexintlvoid)) 

extern  void  dunpl unsigned  int  address,  unsigned  int  length)) 
extern  void  echo! char  data),  portdumpl char  *string)) 
extern  char  termini  void)) 

extern  void  tes t input I  void ) ,  testoutputl void ) ) 


G.  FILENAME  DELAY.H 

/frdelay.h  May  19,  1988  Header  file  for  delay. s  in  ASMSOURCE  directory  */ 
extern  void  delay! int)) 

H.  FILENAME  NEWIO.H 

/*  April  20,  1988  newio.h 

header  for  newio.s,  in  ASMSOURCE  Directory.  */ 

extern  char  input! char  port)) 

extern  void  output! char  port,  char  data)) 

I.  FILENAME  CLOCK.H 

/*  This  file  contains  external  declarations  in  prototype  format  for 
all  the  functions  defined  in  "clock. c".  #/ 

extern  void  clockintl struct  datetime  *clock> struct  idatetime  *iclock)) 
extern  void  clockreadl struct  datetime  *your_clock ) ) 

extern  char  clockcomparel struct  idatetime  *clockl , struct  idatetime  *clock2)) 
extern  void  clocksetl struct  datetime  *clock)> 

extern  void  clocksuml struct  idatetime  »result , struct  idatetime  *clockl» 
struct  idatetime  *clock2>) 
extern  void  dump_c lock! struct  datetime  »clock)) 
extern  void  rtclvoid)) 

extern  void  show_waketimel struct  idatetime  ffwaketime)) 

extern  void  testtimeoutl void ) ) 

extern  char  timeout! int  delaytime, int  measure)) 
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J.  FILENAME  INITIAL.C 


/*  May  20,  1988  initial. c  */ 

/*  Baud  rates:  T0LB1  bit  is  0x07  =  9600,  OxOt  =  4800,  Oxlf  =  2400,  0x3f  =  1200, 
0x7f  =  600,  Oxff  =  300  */ 

^include  "newio.h" 

^include  "solar. h" 
ff include  "solareva .h” 

void  inithardware(void)) 


void  initharcfcrare)  void) 

< 

output) MDR1, 0x00 )i 
output) DDRA1 ,0xf f ) > 
output) DDRB1 ,0xf f ) | 
output) DDRC1 ,0x30 ) ) 
outputlTMOl, OxOOU 
output) TM01 ,0x2S ) ) 
output) T0LBl,0xlf ) ) 
output) T0HB1, 0x00)) 
output) ST ART01 ,0x07 )  1 
output (MDR2, 0x00 ) ) 
output) 0DRA2 ,0x00 ) ) 
output) DDRB2 ,0x00 ) ) 
output) DDRC2 ,0x31 ) ) 
output ) TM02 , 0x00 ) ) 
output) TM02, 0x25)1 
output ( T0LB2 , 0x0a ) ) 
output) T0HB2 ,0x00 ) ) 
output) START02 ,0x0a ) ) 
output) BCLRC2, 0x30)) 

J 


/*  Mode  byte  810  #1,  ) basic  I/O)  */ 

/*  Set  port  A  to  output.  */ 

/*  Set  port  B  to  output.  */ 

/*  Set  port  C  to  input/output.  */ 

/*  Stop  the  timer.  */ 

/*  Set  timer  mode.  */ 

/*  Set  low  byte  for  timer.  IBaud  rate)*/ 
/*  Set  high  byte  for  timer.  */ 

/*  Start  timer.  */ 

/*  Mode  byte  for  810  #2.  */ 

/*  Set  port  A  to  input.  */ 

/*  Set  port  B  to  input.  */ 

/*  Set  port  C  to  input/output.  */ 

/*  Stop  the  timer.  */ 

/*  Set  timer  mode.  */ 

/*  Set  low  byte  for  timer.  */ 

/*  Set  high  byte  for  timer.  */ 

/*  Start  timer.  */ 

/*  Set  bits  in  port  C  */ 


K.  FILENAME  SOLAR.C 


April  11,  1988 


solar. c 


•include  "solareva.h" 
•include  "convert .hM 
•  include  "inout.h" 

•include  "initial .h“ 
•include  "global. h“ 
•include  "clock. h" 

extern  void  execute) void  )) 
extern  void  retrieve) void)) 

void  version) void) ) 
void  memory_dumplvoid)) 
char  menu) void)) 


void  version) void ) 

{ 

portdump) 

" n  rBob  Oxborrow's  Control  Program  for  Solar  Panel  Research.  n,r" ) ) 
portdu.-np(  "Version  1.00  May  9,  1988nrnr")> 

) 

/*  This  routine  lets  the  user  produce  memory  dumps  for  any  section  of  memory.*/ 
void  memory_dump( void ) 

{ 

unsigned  int  address)  /*  Hill  hold  the  starting  address  of  the  dump.*/ 

unsigned  int  length)  /*  Hill  hold  the  number  of  bytes  to  dump.*/ 

while  (TRUE)  < 

portdump) "Please  specify  address:  ")) 
address  =  gethexint) )) 

portdump) " n  rPlease  specify  number  of  bytes  to  cfcjmp  (0  to  quit): 
length  =  gethexint) )) 
if) length  ==  0 ) 
break) 

dump) address , length ) ) 


char  menu) void) 

{ 

char  data) 


while) TRUE)  < 

portdump)  ",n  rSolar  panel  evaluation  control  program. \n,r  n,r"  )) 
portdumpCA  Real  time  clock  functions. 'n  r"  )) 
portdump)  "B  Memory  dump,  nr") ) 
portckmp)  "C  Execution,  n  r"  )) 
portckanpl  "0  Data  Memory,  n  r"  )) 


data  =  termini  )) 
echo) data ) ) 
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portdump!  "  n  r“ ) ) 
switch  (data)  < 

case  ‘a‘:  case  'A': 
rtc(  )  ) 
break) 

case  'b ' :  case  *B’ : 

memory_dump(  )) 
break) 


case  'c':  case  ‘C‘: 
execute!  )) 
break  ) 


case  'd' :  case  'O' : 
retrieve! )) 
break  ) 


1 


default : 
) 


portdump! "Use  a  valid  letter  please!  nr”)) 


X  *  IHHHHHHHHHHHHHHt IHHHUHHHHHHW  XX#**#*/ 

void  main! void) 

{ 

initharcArare!  )  > 

if  ( prtconnected  =  checkprt! ))  { 
version!  ) ) 
menu!  )) 

) 

J  \ 
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L.  FILENAME  CONVERT.C 


/»  April  11»  1988  convert. c  «/ 

^include  "solar. h" 

{(include  "newio.h" 

Binclude  "solareva.h" 


char  atohfchar  *ascii)> 

unsigned  int  atohexinttchar  asciitl)) 

int  atoilchar  «s)) 

char  *bcd_asc! char  bed)) 

int  bcd_intlchar  bed)) 

char  *ctoh!char  byte)) 

char  int_bcd( int  decimal)) 

char  *itoa(  int  n»  char  sill) 

char  tolowerlchar  c)) 

char  *uitoh( unsigned  int  word)) 


/a*##***,)********##*####**#****##*#*#***#**#*##*#***######*#*******#)******#*/ 
/*  This  routine  converts  a  two-byte  ASCII  string  representing  a  valid 
hexadecimal  byte  into  a  single  hexadecimal  byte.  */ 


char  atohlchar  #ascii)  /*A  string  representing  a  hexadecimal  byte.  */ 

< 


int  i ) 

char  result)  /*  The  hexadecimal  byte  after  conversion.  */ 


result  =0) 

for  ( i=0)i  <  HSTRLEN  88  asciilil  !=  NULL)++i)  < 
result  *=  16) 

if  (  ‘O'  <=  asciilil  88  '9'  >=  asciilil) 
result  ♦=  asciilil  -  ’O’) 
else  if  ('a'  <=  asciilil  *8  * f •  >=  asciilil) 
result  +=  10  ♦  asciilil  -  'a') 

1 

return! result ) ) 


/a**#**###*##***#*#****#*********##****#*********#**#*))******#**##***#*#*###/ 

/»  This  routine  converts  a  four-byte  ASCII  string  representing  a  valid 
hexadecimal  word  into  a  single  unsigned  integer.  »/ 

unsigned  int  atohexint! char  ascii!  1) 

< 

int  i) 

unsigned  int  result)  /»  The  hexadecimal  word  after  conversion.  */ 


result  =0) 

for  ( i=0)i  <  HEXINTSTRLEN  88  asciilil  !=  MJLL)++i)  t 
result  *=  16) 

if  (  '0*  <=  asciilil  88  '9'  >=  asciilil) 
result  ♦=  asciilil  -  '0') 
else  if  I 'a'  <=  asciilil  88  'f'  >=  asciilil) 
result  +=  10  ♦  asciilil  -  ‘a’) 

) 
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return! result )  * 


J 


int  a toil  char  *s )  /*  convert  string  to  integer  */ 


static  int  n,  sign) 
sign  =  1) 
n  =  0) 

switch  <«s)  < 

case  :  sign  =  -1 ) 
case  ++s) 

) 

whilj  <*s  >=  'O'  44  *s  <=  '91)  n  =  10  *  n  +  *s++ 
return! sign  *  n)) 


•0‘) 


/It**********************************  it***************************************/ 

/*  Convert  a  byte  of  binary  coded  decimal  data  to  character  string  format.  */ 
/*  No  checK  is  made  to  ensure  that  input  data  really  IS  in  BCD  format.  */ 
char  *bcd_asc(  char  bed)  /*  Tested  March  16,  1987  */ 
i 

static  char  asciil31) 
int  bed int) 

bedint  a  OxOOff  S  ( < int )  bed))  /*  Convert  to  integer.  */ 

/*  If  the  tens  digit  is  a  zero,  put  a  blank  in  its  place) 
otherwise,  put  an  ASCII  digit  there.  */ 
asciitOl  *  (OxfQ  4  bedint)  ? 

<0x30  (bedint  »  4))  :  1  *) 

asciiCll  =  0x30  ((bedint  &  0x0f)))  /*  Get  the  units  digit.  */ 

asciilZl  =  NULL)  /*  Terminate  the  string  with 

a  null.  */ 

return! ascii  ) ) 

1 

/***************************************************************************/ 
/*  Convert  a  byte  of  binary  coded  decimal  data  to  integer  format.  */ 

/*  No  check  is  made  to  ensure  input  data  really  IS  in  BCD  format.  */ 

/•Tested  March  16,  1987  */ 

int  bcd_int(char  bed)  /*  The  BCD  character  to  be  converted.  */ 

l 

int  bedint,  result) 

/*  Take  the  units  by  masking  off  the  tens.  */ 

/*  Then  throw  away  the  units  and  keep 
the  tens.*/ 

bedint  -  OxOOff  4  (int)  bed) 
result  =  OxOOOf  4  bedint) 

/•Multiply  the  tens  by  10,  and  add  to  result.*/ 
result  ♦=  10  *  (bedint  »  4)) 
return*  result ) ) 

1 

/***************************************************************************/ 
/*  Convert  a  character  to  hexadecimal  ASCII  string  format.  */ 
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char  *ctoh(char  byte) 

< 

static  char  ascii(HSTRLENl ) 
int  byteint,  nibble)  base) 


) 


byteint  =  OxOOff  &  ((int)  byte))  /«  Convert  to  integer.  */ 

nibble  *  byteint  »  4)  /*  Get  the  tens  digit.  */ 

/*  Find  out  whether  the  nibble  is  in  the  range  (0-9l>  in  which 
case  its  ASCII  representation  starts  at  0x30  (48  decimal))  or 
[10-15]>  in  which  case  the  ASCII  representation  starts  at 
A  =  0x41  (65  decimal).  In  the  latter  ca$e>  add  the  value  of  the 
nibble  to  65-10  =55.  */ 
base  =  (nibble  >=  10)  ?  55  :  48) 
asciiCOl  =  base  *  nibble) 
nibble  =  byteint  &  OxOf) 
base  =  (nibble  >=  10)  ?  55  :  48) 
ascii(l)  =  base  ♦  nibble) 
ascii(2]  =  NULL) 


/*  Get  the  units  digit.  */ 


/*  Terminate  the  string  with 
a  null .  */ 


return! ascii  ) ) 


/*  This  routine  converts  an  integer  to  a  binary  coded  decimal  character. 
Since  99  is  the  largest  legitimate  BCD  number)  the  argument  "decimal" 
is  taken  modulo  100.  */ 

char  int_bcd( int  decimal)  /*  The  number  to  be  converted.  */ 

{ 

int  result) 


/*  Make  sure  decimal  is  a  positive  number.  */ 
decimal  =  (decimal  <  0)  ?  -decimal  :  decimal) 

decimal  '/.=  100)  /*  If  decimal  is  too  big>  take 

it  modulo  100.  */ 

result  =  (decimal  /  10 )  «  4)  /*  Get  the  tens  and  shift  them  into  the 

high  order  half  of  the  byte.  */ 
result  +=  decimal  Z  10)  /»  Add  in  the  inits.  */ 

return! (char )  result)) 


/*  itoa  -  convert  n  to  characters  in  s.  #/ 
char  *itoa( int  nt  char  s( 1 ) 


static  int  c>  k) 
static  char  *p>  *q) 


if  ( (k  =  n )  <  0 ) 


k 

=  - 

•k) 

q  =  p  = 

S) 

do  < 

*p*  + 

=  k  7.  10  ♦ 

}  while 

(k 

/= 

10)) 

if  ( n  < 

0) 

*p++  =  1 - ' ) 

*p  r  0) 
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) 


while  (q  <  --p)  { 

c  =  #q*  *q++  =  *p  *  *p  =  c (  ) 
return  ( s ) * 


/*«*»*##«^»»##»H(*******#-**#**#****#****#*#~**#***#»»**  a-#**##***##***********/ 
/*  tolower  -  if  the  input  is  in  [A..Z1*  convert  to  lower  case  */ 
char  tolowerlchar  c) 

< 

if  ( 'A1  <=  c  *S  c  <=  'Z' ) 
return  ( c  ♦  0x20 ) * 
return  c* 


> 


/*  Convert  an  unsigned  integer  to  hexadecimal  ASCII  string  format.  */ 
char  ftuitohl unsigned  int  word) 

< 

static  char  ascii (HEXINTSTRLEN  ♦  lb 
unsigned  int  nibble* 
int  i  i 


ascii tHEXINTSTRLEN]  =  NULL* 
for  ( i=0 * i  <  HEXINTSTRLEN*++i  )  { 

/#  Get  the  current  nibble*  in  order  from  most  to  least  significant.  */ 
nibble  =  OxOOOf  &  (word  >>  (4  *  13  -  i))b 

/*  If  nibble  >=  10*  convert  it  to  a  letter  from  *A'  to  *F'. 

If  nibble  <  10»  convert  it  to  a  letter  from  *0‘  to  '9'.  */ 
asciitil  =  (nibble  >=  10)  ?  (  *A'  ♦  nibble  -  10)  :  t 'O'  +  nibble)* 

J 

return! ascii )  * 
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M.  FILENAME  INOUT.C 


/*  April  20*  1988  incut. c  */ 

((include  "solar. h" 

# include  "convert. h“ 

W include  "solareva.h" 

((include  "global. h" 

((include  "newio.h" 

char  checkprt(void)) 

void  dump (unsigned  int  address*  unsigned  int  length)) 

void  echo! char  data)) 

char  gethex(void)) 

unsigned  int  gethexint(void)) 

int  getint(void)) 

void  portdumpl char  ^string)) 

char  termini  void )) 

void  testinput(void)) 

void  testoutput(void)) 

/*  This  routine  checks  to  see  if  there  is  a  printer  connected  to  the 
controller.  It  returns  TRUE  if  there  is  one*  FALSE  otherwise.  */ 
char  checkprt(void) 
i 

/*  If  the  TERMON  bit  of  the  READC1  port  is  0,  then  a  terminal 
is  connected.  In  this  case  return  TRUE)  FALSE  otherwise.  */ 

/#  This  is  temporary  until  we  get  the  terminal  recognition  hardware  working.  */ 
/*  return! (  input! REA0C1 ) )  &  TERMON))*/ 

return! TRUE  ) ) 

1 


/*  This  routine  produces  a  hexadecimal  cHjmp  of  any  section  of  memory.  */ 
void  dump! unsigned  int  address*  unsigned  int  length) 
t 


unsigned  int  i)  /#  Points  to  the  current  byte  being  dumped, 

char  asciil DUMPWIDTH+1 1 )  /*  Contains  the  ASCII  equivalent  of  each  byte.  */ 


*/ 


ascii tDUMPWIDTH]  =  NULL)  /*  Make  sure  ascii  has  a  null  delimiter 

to  look  like  a  C  string.  */ 

/*  Convert  length  to  a  multiple  of  DUMPNIDTH.  */ 
length  =  ((length  ♦  DUMPNIDTH-1 (/DUMPNIDTH )  *  DUMPNIDTH) 
for  ( i=0)i<length)i*+ )  < 

if  ( 0==i>!DUMPHIDTH )  {  /*  Dump  the  ascii  version  and  start  a  ! 

new  line  every  DUMPNIDTH  character! 
if  (i  >  0)  <  , 

portdumpl ascii ))  | 

portdumpl  "  n  r"  )  > 

3 

portdumpl uitohl address+i )) >  /*  Also*  dump  the  current  address.  */ 
portdumpl":  ")> 

3 


/*  Put  extra  spaces  in  the  middle  of  each  line.  */ 


if  ( 0==iZ(  DUMPWIDTH/2 )  St  0  !=  iXDUMPNIDTH)  i 
portdumpl "  “)) 

) 

portdumpl ctoh(*( char  *)  (address+i ) )  ))  /*  Dump  each  byte  individually.  */ 

portdunpl"  " )) 

/*  Insert  the  current  character  in  the  string  "ascii".**/ 

/*  If  it's  not  printable*  replace  it.  */ 
ascii!  iXOLWPWIDTHJ  =  *<char  *)  (acfdress  +  i)( 

if  ( ascii! i/DUMPWIDTH 1  <  SPACE  asciit i/DUMPMIDTH ]  >=  DELETE)  C 
ascii! i/DUMPWIDTH 1  =  *.*» 

> 

1 

/*  Make  sure  ascii  is  printed  again  at  the  end  of  the  last  line.  */ 
if  (i  >  0)  < 

portdumpl ascii ) ) 
portdumpl  "  n  r"  )) 

) 


/a****************)*****************************************  *****  ******  ******/ 
/*  Echo  a  character  to  the  terminal.  */ 
void  echo) char  data) 
l 

char  buf [ 2 1 t 
buf(0]  =  data) 

bufll]  =  NULL)  /»  Buf! J  ends  in  a  null  because  it’s  a  C  string.  */ 
portdumpl buf ) )  /*  Use  portdumpl  )  to  output  the  string.  */ 

> 


/*  This  routine  gets  a  hexadecimal  byte  from  the  terminal.*/ 


char  gethexlvoid) 
t 


int  i) 

char  string! HSTRLEN  ♦  ll> 

stringtHSTRLENl  =  NULL) 
for  I i=0)i  <  HSTRLEN)+*i )  i 

string! il  =  tolowerl termini  )) ) 
echo! string! i J )> 

if  Istringli]  >-  'a'  SS  stringli]  < 
continue) 

if  Istringli]  >=  'O'  SS  stringli)  < 
continue) 
string! i  ]  =  NULL) 
break ) 

) 

return! atohl string ) ) ) 


/*  This  routine  gets  a  hexadecimal  word  I  two  bytes)  from  the  terminal.*/ 
/a*********************************************************  *****************/ 
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unsigned  int  gethexint! void ) 

C 

int  i  i 

char  string! HEXINTSTRLEN+1 J ) 

string! HEXINTSTRLEN]  =  NULL} 
for  (  i=0}i  <  HEXINTSTRLEN)++i  1  < 

string! il  =  toloMer! termini  ) )} 
echo! string! ills 

if  ( string! i 1  >=  'a'  S*  string! i]  <=  'f  • ) 
continue} 

if  ( string!  i  1  >=  '0*  it  stringli]  <=  'V) 
continue} 
stringli]  =  NULL) 
break ) 

) 

return! atohexint! string ) ) ) 


) 


/*  Get  an  integer  from  the  terminal.  */ 
int  getint(void) 

< 

int  i ) 

char  string! STRLEN1) 


string! STRLEN 1  =  NULL) 
for  ( i=0)i  <  STRLEN)++i )  < 

stringli]  -  termini)} 
echo! string! ills 

if  (stringli!  <  'O'  stringli]  > 
string! i  ]  =  NULL) 
break ) 

J 


} 

return! atoil string) )} 


■9'  ) 


{ 


/«  This  routine  sends  character  strings  to  the  PRTDATA  port.  */ 
void  portdump! char  »string> 
t 


if  ( Iprtconnected) 
return) 

while  (»string)  C 

/*  The  terminal  is  ready  when  status  bit  0  is  a  one.  */ 
while! IIPRTOUTROY  t  input! PRTCTRL ))) ) 
output! PRTDATA, *string++ )) 


) 


) 


char  termini  void) 
{ 


while  (TRUE  )  C 

/*  Bit  1  will  be  1  when  data  is  present.  Wait  for  data.  */ 
if  l input! PRTCTRL  )  &  PRTRDY  ) 
break  ! 

) 

return! input! PRTDATA )) i  /*  Data  is  present >  so  read  it.  */ 


void  testinput! void ) 

£ 

int  port!  /*  Port  number  to  be  entered  from  the  keyboard.*/ 

char  data!  /•  Data  to  be  read  from  that  port.  */ 

portdump! "Specify  port  address  to  be  read  (in  hexadecimal):  ")! 
port  =  gethexl  ) !  /*  Get  the  port  address.  */ 

portdump! "  nr")! 

data  =  input (port)!  /*  Read  from  the  port.  */ 

portdump! "Data  from  port  (in  hexadecimal):  “ )! 
portdump! ctohl data  )  ) ! 
portdump! " n  r"  )  ( 


/it*******#**************************#***************************************/ 

/*  This  routine  outputs  a  character  to  a  specified  port.  */ 

/«**«*  ***»****!Ht******»*»****«*****tt******»tt********»»«)HHHHHHHHW(***********/ 
void  testoutput! void ) 

< 

int  port!  /*  The  port  address.  */ 

char  data!  /*  The  data  to  be  sent  to  the  port.  */ 


portdump! "Specify  port  address  to  be  written  to  (in  hexadecimal):  ")! 
port  =  gethexl )!  /#  Get  the  port  address.  */ 

portdump! " n  r" ) I 

portdump! "Specify  the  data  to  be  sent  to  the  port  I  in  hexadecimal):  ")| 
data  =  gethexl )| 
output! port ,data ) ( 


N.  FILENAME  NEWIO.S 


)  February  19;  1988  newio.s 


export 

input;  output 

region 

code 

>  char  input! char  port)) 

input: 

push  ix 
Id 

ix  ;  0 

) The re  are  no  local  variables. 

add 

ix,sp 

Id 

C;<  ix*4) 

)Put  port  address  in  register  c. 

in 

a>(c) 

)Get  the  data  -from  the  port. 

pop 

ix 

)Restore  ix  to  the  value  it  had  before  this 
) function  was  called. 

rot 

>  void  output  (char  port;  char  data)) 


output : 

push 

ix 

Id 

ix  ;  0 

)There  are  no  local  variables. 

add 

ix  ;  Sp 

Id 

C;(  ix+4) 

)Put  port  address  in  register  c. 

Id 

a ;(  ix+6 ) 

)Put  data  in  register  a. 

out 

(c),a 

)Write  the  data  to  the  port. 

pop 

ix 

)Restore  ix  to  the  value  it  had  before  this 
)function  was  called. 

ret 
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O.  FILENAME  START.S 


February  19,  1988  start. s 

This  startup  cod#  initializes  interrupt  vectors  and  runs  START  at 
reset 

to  initialize  RAM  and  call  the  user  function  main(  ). 

The  companion  link  specification  file  is  "spec"  which  defines 
many  of  the  imported  symbols.  Also  see  file  "mbrk.asm"  for  the 
mbrkl  )  function  if  you  want  to  use  mallocl  )  or  callocl ). 


export  START, MBRKPTR 

import  ma in , ST ACKT OP , RAMD AT  A , ZRAM , ZRAMSZ , I RAM , I RAMSZ ,MRAM 


)  Define  a  variable  to  track  memory  allocations  in  mbrk(  ). 

region  ram 

MBRKPTR  ds  2  J  (char  *)  to  available  memory 


)  Reset  code  must  be  linked  to  address  0. 

)4Ht******* ************************************************  »»**««*****«** 
region  reset 

Id  sp,  10  STACKTOP  i  initial  stack  pointer  (0x10000  as  0) 

jp  START  i  initial  execution  address 

org  0x08 

ARESTART:  > RESTART  LOCATION  1 

jp  START 

org  0x10 

BREST ART :  j RE ST ART  LOCATION  2 

jp  START 

org  0x18 

CRESTART:  » RESTART  LOCATION  3 

jp  START 

org  0x20 

□RESTART:  > RESTART  LOCATION  4 

jp  START 

org  0x28 

ERESTART:  j REST ART  LOCATION  5 

jp  START 

org  0x2C 

FRESTART:  jRESTART  LOCATION  C 

jp  START 

org  0x30 

GRESTART;  ) RESTART  LOCATION  6 

jp  START 

org  0x34 

HRESTART:  >RESTART  LOCATION  B 

jp  START 

org  0x38 

IRESTART:  j RESTART  LOCATION  7 

jp  START 
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org  0x3C 

JRESTART :  » RESTART  LOCATION  A 

jp  START 

org  0x66 

NONMASK I:  (NON-MASKABLE  INTERRUPT 

jp  START 


This  code  can  be  anywhere t  the  reset  code  jumps  to  it. 


START 


region  code 
Id  ix,0 

Id  hl»MRAM 

Id  ( MBRKPTR ) ,hl 


>  end  of  stack  frame  chain 
t  initialize  memory  allocator 


(JHHH 

( 

)  It 
)  as 

Zero 

is  assumed  here 
long  as  MBRKPTR 

out  uninitialized  RAM. 
that  ZRAMSZ  >  1  but  this  is  guaranteed 
(above)  is  defined  in  region  ram. 

Id 

hl.ZRAM 

\  zero  ZRAMSZ  bytes  hare 

Id 

(hi  1,0 

t  zero  first  byte 

Id 

de,ZRAM+l 

l  repeatedly  zero  other  bytes 

Id 

bc,ZRAMSZ-l 

ldir 

t x n nnn nnnnnnnn "n n n Wn A nn n nn n n n n n nn nn nn n x a A n nn nn xn nnnnn 

*  Initialize  other  RAM  from  ROM. 

I  ****************************  ******************************* 


Id 

hl.RAMDATA 

Id 

de.IRAM 

Id 

be  ylRAMSZ 

Id 

a»b 

or 

c 

jr 

ldir 

z .none 

none: 


done: 


w^www^MWWWWMMWMMWt#Wl#MWWt/WWWWWWWWWWt#WWMWMWWlfWMi*MMWMWWWWMMMMW 
^  ^A  ^A^A^A^A^A  ^A^A^A^A^A^A^A^A^A^A^A^A  ^A^A^A^A^A^A  ^A^A^A^A^A^A^A  ^A^A  ^A^A^A^A^A^A^A^A^A^A^A  ^A^A  ^A^A^A^A^A^A^A^A^A^A^A^A^A 

)  Invoke  main!  )  with  no  arguments. 


call  main  l  any  return  value  is  "int"  in  de 

halt  )  halt  if  main  returns 


To  vector  an  interrupt  to  a  C  function>  you  must  go  though 
a  register  save  routine  like  the  one  shown  here. 

If  the  ”-r  exx”  option  is  being  given  to  the  command  line* 
then  registers  be'  de'  and  hi1  need  not  be  saved  and  restored 
since  the  compiler  will  make  no  use  of  them.  The  compiler 
does  not  use  af'  in  any  case. 


region  code 


INTERRUPT 


push  af 

push  be 


t  save  registers 


push 

de 

push 

hi 

push 

ix 

push 

iy 

exx 

push 

be 

push 

de 

push 

hi 

exx 

call 

efen 

exx 

pop 

hi 

pop 

de 

pop 

be 

exx 

pop 

iy 

pop 

ix 

pop 

hi 

pop 

de 

pop 

be 

pop 

af 

ei 

ret 

)  call  soma  C  function 
>  restore  registers 


I  return  from  interrupt 
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P.  FILENAME  GLOBAL. C 


/*  April  19,  1988  global. c  */ 

# include  "solareva.h" 

char  prtcormected)  /*  TRUE  is  there  is  a  terminal  attached, 

FALSE,  otherwise.  */ 

struct  datetime  clock)  /*  The  most  recently  read  time  will  be  stored 

here .  »/ 

struct  idatetime  waketime)  /*  The  most  recently  read  integer  version  of 

time  will  be  stored  here.  */ 


Q.  FILENAME  CLOCK.C 


/*  April  1 9>  1988  clock. c  #/ 

^include  "solar. h" 

Rinclude  "convert. h" 

^include  "inout.h" 

Rinclude  "solareva.h" 

^include  "global. h" 

^include  "newio.h" 

void  clockint! struct  datetime  «clock>struct  idatetime  *iclock)) 
void  clockread! struct  datetime  *your_clock  )  ) 

char  clockcompa ref  struct  idatetime  *clockl , struct  idatetime  *clock2Jj 
void  clocksetf struct  datetime  ftclockli 

void  clocksumf struct  idatetime  *result , struct  idatetime  *clockl> 
struct  idatetime  #clock2i) 
void  dump_clock< struct  datetime  #clock)> 
void  rtc(void)) 

void  show_waketime! struct  idatetime  *waketime)) 
void  testtimeout! void ) ) 

char  timeout! int  delay time, int  measure)) 


/a*****##*********#******#*********#**#******#********#****##**##*##***#****/ 
/*  Convert  a  datetime  structure  to  an  idatetime  equivalent.  This  allows 
arithmetic  to  be  performed  on  dates  and  times.  */ 
void  clockintf struct  datetime  *clock, struct  idatetime  #iclock) 


< 


) 


iclock->imonth 
iclock->idate 
iclock->ihour 
iclock->iminute 
iclock->i second 


=  bcd_int( clock->month )  > 

=  bcd_ int! clock- >date  ) } 

=  bcd_int( clock->hour  ) ) 

=  bcd_int(  clock->mir>ute  ) ) 
=  bcd_int( clock->second ) ) 


/*  This  routine  fills  a  clock  structure  with  the  current  date  and  time.  «/ 
void  clockreadl struct  datetime  *your_clock  ) 

int  i ) 

i  =  0> 
do  < 

your_clock->second  =  input! SECONDS ) ) 

your _c lock ->minute  =  input! MINUTES ) ) 

your_clock->hour  =  input! HOURS ) ) 
your_clock->date  =  input! DATE)) 
your_clock->month  *  input! MONTH )> 

)  while  ( your_clock->second  !=  input! SECONDS  )  tt  +  +  i  <  =  10  *  TRIES)) 

} 

/***»#*****«#*»#***##**#*******•»*********#*#**#****#****##»##*»#*« #*****»**«/ 

/*  Compare  two  clock  times.  Return  TRUE  if  the  first  is  later  than  the  second. 
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FALSE  otherwise.  */ 

char  clockcompare! struct  idatetime  *clockl »struct  idatetime  #clock2  ) 

C 

int  difference) 

difference  =  clockl->imonth  -  clock2->imonth) 

/*  This  logic  allows  you  to  decide  January  comes  after  December.  */ 
if  ((difference  ♦  12 1  '/.  12  <  6 

&&  difference  !=  0)  return! TRUE  ) ) 
if  (differ^ v.e  !=  0)  return! FALSE  ) ) 
if  (clockl->idate  <  clock2->idate )  return! FALSE ) > 
if  (clockl->ihour  <  clock2->ihour )  return! FALSE ) ) 
if  (clockl->iminute  <  clock2->imir»ute )  return!  FALSE  ) ( 
if  (clockl->isecond  <  clock2->isecond )  return! FALSE  ) ) 
return! TRUE )) 

} 


/*  This  routine  sets  the  real  time  clock.  #/ 
void  clockset! struct  datetime  »clock ) 
t 


int  month,  date,  hour,  minute,  second,  maxdate) 

char  outstrtSTRLEN ] ) 

static  char  cr[  1  =  "nr") 


while  ( TRUE  1  < 

portdump! "Month?  (1-12)  ")) 

month  =  get int! ) ) 
if  (month  >=  1  &&  month  <*  12) 
break ) 

portdump!  "Invalid  month.  Re-enter  it.\nr")) 

) 

portdump! cr ) ) 


maxdate  =  (month  ==  4 

month  ==  6 

month  ==  9 

month  ==  11 )  ? 

30  :  31) 

maxdate  =  (month  ==  2 )  ?  28  :  maxdate) 
while  (TRUE  )  { 


portdump! "Day?  fl-")) 
itoa! maxdate , outs tr ) ) 
portdienp!  outstr ) ) 
portdump!")  ")) 
date  =  getint! ) ) 

if  (date  >=  1  it  date  <=  maxdate) 
break) 

portdump!  "\n  rlnva lid  date.  Re-enter  it.  ,n\r"l) 

} 

portdump!  cr ) ) 
while  (TRUE)  { 

portdump! "Hour?  (0-23)  ")) 

hour  =  getint!  )) 
if  (hour  >=  0  tt  hour  <=  23) 
break ) 

portdump!  "Invalid  hour .  Re-enter  it. 'nr")) 

J 

portdump! cr ) ) 
while  (TRUE  )  < 
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t 


■ 


v. 


1 

m 


j 


portdunp!  "Minute?  (0-59)  ")) 

minute  =  getint!  )) 
if  (minute  >=  0  &&  minute  <=  B9) 
break) 

portdunpl  "Invalid  minute.  Re-enter  it.\n  r“ )) 

) 

portdumpl cr)) 
while  (TRUE)  f 

portdunpl  "Second?  (0-59)  •')) 

second  =  getintl  ) ) 
if  (second  >=  0  &&  minute  <=  59) 
break) 

portdumpl  “Invalid  second.  Re-enter  it.\n  r")) 

) 


portdumpl cr ) ) 

clock->month 

clock->date 

clock->hour 

clock->minute 

clock->second 


=  int_bcd ( mon  th ) ) 

=  int_bcd(  date ) ) 
=  int_bcd( hour  ) ) 
=  int_bcd( minute ) ) 

=  int_bcd( second ) ) 


output! MONTH ,clock->month ) ) 
output! DATE ,clock->date ) ) 
output! HOURS, clock- >hour ) ) 
output! MINUTES, clock->minute ) ) 
output! SECONDS , clock- >second ) ) 


/*  Find  the  sum  of  two  calendar  periods.  */ 

void  clocksum! struct  idatetime  ^result, struct  idatetime  »clockl, 
struct  idatetime  »clock2) 


t 


int  maxdate) 


/»  The  last  valid  date  in  the  month.  */ 


result->isecorvd  =  clockl->isecond  ♦  clock2->isecond) 
result->iminute  =  result->isecond  /  60) 
result- >isecond  60) 

result->iminute  ♦=  clockl->iminute  ♦  clock2->iminute) 
result->ihour  =  result->iminute  /  60) 
result->iminute  60) 

result->ihour  +=  clockl->ihour  +  clock2->ihour ) 
result->idate  =  result->ihour  /  24) 
result->ihour  '/.=  24) 

result->idate  +  =  clockl->idate  +  clock2->idate) 
result->imonth  =  1  ♦  ( clockl->imonth  +  clock2->imonth  -  1 )  '/.  12) 
maxdate  =  ( ( result->imonth  ==  4)  ( resul t->imonth  ==  6) 

( result->imonth  ==  9)  (  result->imonth  ==  ID)  ?  50  :  51) 

/*  The  real  time  clock  makes  no  provision  for  leap  year,  so  leap  years 
are  ignored  in  this  program  (sigh!)  */ 
maxdate  =  ( result->imonth  ==  2 )  ?  28  :  maxdate) 
result->imonth  ♦=  ( result->idate  -  1)  /  maxdate) 
result->idate  =  1*  ( resul t->idate  -  1)  V.  maxdate) 
result->imonth  =  1  +  ( result->imonth  -  1 )  '/.  12) 
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/*  Print  a  clock  structure  or  dump  it  to  the  output  port.  */ 
void  dump_clock( struct  datetime  Kclock ) 
t 

if  l  prtcomected )  C 

port dump! "Month  ==  "  ) ) 
portdumpl bcd_asc( clock->month ) ) ) 
port dump! "  Date  ==  " I ) 
portdumpl bcd_asc( clock ->da to )  )> 
portdumpl"  Hour  ==  ")) 
portdumpl bcd.ascl  clock->hour ) ) ) 
portdumpl"  Minute  ==  “)) 
por tdunpl bcd_asc( clock->minute  ) )  l 
portdumpl"  Second  ==  ")) 
portdumpl  bcd.ascl  clock->secortd  ) )  ) 
portdumpl  " .  ,n  r"  )  ) 

) 

> 

f  a™  A  A  nn  wnRn  nW  A  a  n  Wn  f 

/*  This  routine  is  a  menu-driven  collection  of  routines  for  testing  the 
clock  functions.  */ 
void  rtclvoidl 
{ 

char  data) 

while  (TRUE)  l 

portdumpl  "  n  rReal  time  clock  functions .  n  r, n  r"  ) ) 

portdumpl  "A  Read  clock,  nr")) 

portdumpl "B  Set  clock. , n.r" )) 

portdumpl  ”C  Test  timeout!)  function. ,  n.r"  ) ) 

portdumpl "Z  Return  to  main  menu.  n,r")) 

data  =  termini  ) ) 
echo! data  )  > 
portdumpl " n  r"  )) 
switch  (data)  { 

case  'a':  case  'A': 

clockreadl Sclock )  i 
dump_clock( Sclock ) ) 
break) 

case  'b':  case  'B': 

clocksetl Sclock ) ) 
break) 

case  'c':  case  *C': 

testtimeoutl  )) 
break ) 

case  'z':  case  'Z': 
return) 

default : 

portdumpl  "Use  a  valid  letter  please. ',n,r"  )> 
break ) 
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/*»»*#*»**»**#****»#******»**##*#*#***##****#*********#•**#**#*«*###»#*##**«#/ 

/*  This  routine  displays  the  wake-up  time.  */ 
void  show_wake timet  struct  idatetime  *waketime) 

< 

char  sISTRLEN))  /*  String  for  itoat  )  routine.  »/ 

portckjmpt  "Hake-up  time  is:  \n  rMonth  =  ")> 

port dump) itoat  wake time- >imonth>s  )) ) 

portdumpt"  Date  =  ")) 

portdumpt itoa(waketime->idate,s ) )) 

portdunpl"  Hour  =  "  )) 

portckjmpt  itoat waketime->ihour ,s )) ) 

portdumpt"  Minute  =  " ) l 

portdumpt itoat waketime->iminute,s  )  )> 

portdumpt  “  Second  =  ")> 

portdumpt itoa(waketime->isecond>s  ) ) ) 

portdumpt  "  n  r" )  J 

) 

/*  This  routine  is  used  to  test  the  timeout!  )  function.  #/ 
void  testtimeoutt void ) 
t 

char  data>  /*  A  character  entered  from  the  keyboard.  */ 

units j  /*  The  units  of  delay.  »/ 

int  delay)  /*  The  number  of  units  of  delay.  */ 

while  (TRUE  I  f 

portdumpt  "Test  of  timeout!)  function,  \ri Tinr"  )) 

portdumpt  "Specify  time  units  for  delay :  ,n  r  n  r"  ) ) 

portdumpt  "A  Hours  nr")) 

portdumpt  "B  Minutes  nr")) 

portdumpt  "C  Seconds  nr")) 

portdumpt  "Z  Return  to  previous  menu.\nr")> 

data  =  termint  ) > 
echo! data ) ) 
switch  (data)  f 

case  'a':  case  'A': 

units  =  HOURS) 
break) 

case  'b':  case  'B' : 

units  =  MINUTES) 
break) 

case  'c':  case  'C's 

units  =  SECONDS) 
break) 

case  'z' :  case  'Z' : 
return) 
break) 

default: 

portckjmpt  "Use  a  valid  letter  please,  n r" )> 
break) 

> 

portdumpt  "  n  rHow  many  units  of  delay  do  you  want?  nr")) 
delay  =  getintt  )> 
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portdump!  "  n  rStarting  delay:  nr")) 

clocKresdt  (clock  I ) 

dump. clock: (clock  ) ) 

timeout! delay .units  I ) 

while!  ! timeout (NULL, NULL  )  )) 

portdumpl  "Delay  complete,  nr")) 

echo! BELL )) 

clocKreadf (clock ) ) 

dump_clock( (clock ) ) 

1 

J 


/*  This  routine  is  used  to  initiate  a  timeout  sequence*  and  to  test  for 
completion.  To  set  the  desired  delay  time*  the  parameter  "delay" 
should  be  non-zero.  To  test  for  completion*  "delay"  should  be  zero  (NULL). 
Wien  setting  the  delay  time,  the  fLnction  always  returns  TRUE.  Wien 
testing  for  completion*  it  returns  TRUE  if  the  time  has  elapsed*  FALSE 
otherwise.  */ 

char  timeout! int  delaytime, int  measure) 

/*  "delaytime”  is  the  length  of  the  timeout.  «/ 

/*  "measure"  is  the  unit  of  measure  of  time.  This  can  be 

MONTH,  DATE,  HOURS,  MINUTES,  or  SECONDS.  */ 


< 


static  struct  datetime  timenow) 

static  struct  idatetime  itimenow,  waittime) 


1 


clockread! (timenow ) ) 
clockint! (timenow, (itimenow)) 

if  (delaytime  ==  NULL)  <  /*  If  delaytime  ==  NULL,  then  check  to 

see  if  timeout  period  is  over.  */ 
return) clockcomparel (it imenow , (wake  t ime ) ) ) 

1  else  {  /•  Otherwise*  set  the  wakeup  time.  •/ 

waittime. imonth  =  wait time . idate  -  waittime. ihour 
*  waittime. iminute  =  waittime. isecond  *  D) 
switch! measure )  { 

case  MONTH: 

waittime. imonth  -  delaytime) 
break ) 
case  DATE : 

waittime. idate  -  delaytime) 
break) 
case  HOURS: 

waittime. ihour  =  delaytime) 
break) 

case  MINUTES: 

waittime. iminute  =  delaytime) 
break) 

case  SECONDS: 

wait time. isecond  =  delaytime) 
break) 

) 

clocksum! (waketime, (itimenow, (waittime)) 
show .wake timet (waketime  I ) 

return! TRUE  )) 

> 
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R.  FILENAME  DELAY.S 


>  Hay  09 >  1988  delay. s 

•define  IOOPCOUNT  100 

}  Delay  for  n  thousands  of  a  second. 
i  void  delay) n) 


i  int 

ni 

The  number  of 

thousands  of  seconds  of  delay  desired. 

export 

delay 

region 

code 

delay: 

push 

ix 

J 

t=15T . 

l 

Cause  ix  to  point  to  the  first  parameter 

Id 

ix>4 

> 

t=14T . 

add 

ix,sp 

J 

t=15T . 

Id 

c,<  ix+0 ) 

\ 

t=19T . 

Id 

b,(  ix+1  ) 

> 

t=19T. 

L00P1 : 

Id 

de  ,$ LOOPCOUNT 

t=10T. 

LOOP 2: 

dec 

de 

i 

t=  6T .  Count  down  to  zero  in  L0OP2. 

Id 

a  ,d 

i 

t=  4T . 

or 

e 

t=  4T. 

JP 

nz,L00P2 

> 

t=10T.  Inner  loop  t=24T. 

dec 

be 

i 

t=  6T .  Repeat  LO0P1  until  time  is  up. 

Id 

a,b 

> 

t=  4T . 

or 

c 

> 

t=  4T . 

jp 

nz, LOOP 1 

> 

t=10T .  Outer  loop  t=< 34+24«L00PC0UNT )T. 

pop 

ix 

* 

t=14T.  Restore  ix  to  its  initial  value. 

ret 

t=10T . 

i 

Total  Delay  34*24*LOOPCOUNT)*n)T. 

j  Solve  n  ms  =  ( 106+) 34+24«L00PC0UNT )«n)T  with  T  =  1/f  =  400  ns  to 

i  get  n  =  L00PC0UNT .  f  =  2.5  MHz.  For  n=100,  LOOPCOUNT  =  100,  leading 

j  to  a  delay  of  97.4  ms  for  an  error  of  Z.6'/.  For  n*l» 

>  this  leads  to  a  delay  of  1.016  ms  instead  of  the  1  ms  required,  for 

i  and  error  of  1.6/. 
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S.  FILENAME  SYMBOLS 


RAMDATA 

( spec-file ) 

absol 

RAMDATA 

818bh 

Oh 

ENDROM 

< specf ile ) 

absol 

ENDROM 

aOOOh 

Oh 

I  RAM 

( specf ile ) 

absol 

IRAM 

aOOOh 

Oh 

IRAMSZ 

( specf ile ) 

absol 

IRAMSZ 

8h 

Oh 

ENDOATA 

( specf ile ) 

absol 

ENDDATA 

8193h 

Oh 

ZRAM 

( specf ile ) 

absol 

ZRAM 

aOOSh 

Oh 

ZRAMSZ 

( specf ile ) 

absol 

ZRAMSZ 

106bh 

Oh 

MRAM 

( specf ile ) 

absol 

MRAM 

b073h 

Oh 

MRAMSZ 

( specf ile ) 

absol 

MRAMSZ 

2S0h 

Oh 

STACKTOP 

1 specf ile ) 

absol 

STACKTOP 

lOOOOh 

Oh 

START 

code 

reloc 

START 

69h 

42h 

main 

code 

reloc 

void  main! )} 

199h 

SOh 

MBRKPTR 

ram 

reloc 

MBRKPTR 

a008h 

Oh 

_fltus 

ram 

reloc 

unsigned  char  _fltus}b072h 

Oh 

cg 1 lnun 

ram 

reloc 

int  cellnum} 

a02dh 

Oh 

version 

code 

reloc 

void  version! )} 

93h 

12h 

memory_dump 

code 

reloc 

void  memory _dumpl ) ) 

a4h 

lbh 

test -timeout 

code 

reloc 

void  testtimeout!  )} 

ce7h 

flh 

show_wake time 

code 

reloc 

void  show_waketime( )}  bflh 

deh 

itoa 

code 

reloc 

unsigned  char  *itoa( 

) )ldf 2h 

9ah 

atoh 

code 

reloc 

unsigned  char  atoh!  )}19b5h 

lbh 

ctoh 

code 

reloc 

unsigned  char  *ctoh(  Hlcbch 

bfh 

atoi 

code 

reloc 

int  atoil ) } 

lb4ah 

3bh 

_stod 

code 

reloc 

int  _stod!  )} 

365Sh 

dh 

printf 

code 

reloc 

int  printf! ) } 

360fh 

ldh 

uitoh 

code 

reloc 

unsigned  char  *uitohl  Hledbh 

b8h 

dump 

code 

reloc 

void  ckimpl  )) 

edSh 

23h 

atohexint 

code 

reloc 

unsigned  int  atohexint! )>la4eh 

2ah 

i 

ram 

reloc 

int  i> 

a035h 

Oh 

waketime 

ram 

reloc 

struct  waketime} 

b064h 

Oh 

clockcompare 

code 

reloc 

unsigned  char  clockcompare!  )}315h 

3bh 

ciocksum 

code 

reloc 

void  ciocksum! )} 

735h 

8bh 

clock int 

code 

reloc 

void  clockint!  )} 

ladh 

lah 

clockset 

code 

reloc 

void  clockset! )} 

42fh 

48h 

c_bits 

ram 

reloc 

struct  *c_bits> 

a044h 

Oh 

_vsgn 

code 

reloc 

_vsgn 

7a28h 

bh 

timeout 

code 

reloc 

unsigned  char  timeout! )}dfch 

127h 

dumpclock 

code 

reloc 

void  dump_clock( )} 

a77h 

abh 

_ultos 

code 

reloc 

_ultos 

36f  7h 

29h 

output 

code 

reloc 

int  output!  )} 

1952h 

12h 

currentout 

ram 

reloc 

float  currentout} 

aD3eh 

Oh 

clock read 

code 

reloc 

void  clockread! )} 

264h 

25h 

clock 

ram 

reloc 

struct  clock} 

b05dh 

Oh 

rtc 

code 

reloc 

void  rtc!  )} 

b3dh 

bah 

echo 

code 

reloc 

void  echo! )} 

1082h 

4ch 

inithardware 

code 

reloc 

void  inithardware!  )} 

1434h 

cfi 

_muld 

code 

reloc 

int  _muld( )} 

47e3h 

9ch 

currentdata 

ram 

reloc 

unsigned  char  currentdata}a038h 

Oh 

oldcurrent 

ram 

reloc 

unsigned  char  oldcurrent}  a043h 

Oh 

voltdata 

ram 

reloc 

unsigned  char  voltdata}  a037h 

Oh 

port dump 

code 

reloc 

void  portdumpl  )}  131eh 

97h 

input 

code 

reloc 

unsigned  char  input! )}1942h 

7h 

retrieve 

code 

reloc 

void  retrieve!  ) } 

16eeh 

71h 

cell 

ram 

reloc 

int  cell} 

a031h 

Oh 
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r 


’i 


menu 

code 

reloc 

unsigned  char  menu! )>  f4h 

2ah 

_mulww 

code 

reloc 

_mulww 

993h 

bh 

_dtos 

code 

reloc 

int  _dtosl ) > 

369ch 

17h 

oldvolt 

ram 

reloc 

unsigned  char  oldvolt }a042h 

Oh 

cnvgncdone 

ram 

reloc 

unsigned  char  cnvgncdone }a039h 

Oh 

get hex int 

code 

reloc 

unsigned  int  gethexint!  )}1187h 

6eh 

test  input 

code 

reloc 

void  testinput!  )  } 

138fh 

afh 

delay 

code 

reloc 

void  delay! )» 

lffefh 

ch 

_modsww 

code 

reloc 

_modsww 

4a7ch 

14h 

expe  r i men t_da ta 

ram 

reloc 

struct  experiment_data<100h|98h| >a046h  Oh 

execute 

code 

reloc 

void  execute! 1 ) 

152ch 

2eh 

bcd_asc 

code 

reloc 

unsigned  char  #bcd 

Lascl  )}lbeOh 

4ch 

bcd_int 

code 

reloc 

int  bcd_intl )i 

lc49h 

60h 

prtcormected 

ram 

reloc 

unsigned  char  prtconnected}b05ch 

Oh 

int_bcd 

code 

reloc 

unsigned  char  int_ 

bed!  )}ld64h 

89h 

termin 

code 

reloc 

unsigned  char  termin!  )}1373h 

a4h 

getint 

code 

reloc 

int  getint! )} 

126ch 

84h 

testoutput 

code 

reloc 

void  testoutput!  )  }13e9h 

cOh 

gethex 

code 

reloc 

unsigned  char  gethex!  )}10a4h 

57h 

checkprt 

code 

reloc 

unsigned  char  checkprt!  )ved2h 

17h 

_divwws 

code 

reloc 

_divwws 

lfach 

16h 

command 

data 

reloc 

struct  command } 

a003h 

Oh 

vol tage 

ram 

reloc 

int  voltage} 

a02fh 

Oh 

tolower 

code 

reloc 

unsigned  char  tolower!  Hleaah 

aeh 

vol tout 

ram 

reloc 

float  vol tout} 

a03ah 

Oh 

row 

ram 

reloc 

int  rows 

a033h 

Oh 

_subd 

code 

reloc 

int  _subd( )} 

450 9h 

6ch 

_stol 

code 

reloc 

int  _stol( )} 

3ee5h 

23h 

_ round 

data 

reloc 

int  _round} 

a004h 

Oh 

_tstd 

code 

reloc 

int  _tstd<  )) 

3fe0h 

12h 

_sltoa 

code 

reloc 

unsigned  char  »_sltoal  )}5577h 

14h 

_shrul 

code 

reloc 

int  _shrul( )} 

6306h 

lch 

_shlul 

code 

reloc 

int  _shlul( )} 

63f  2h 

2ah 

_sltos 

code 

reloc 

_sltos 

36d6h 

28h 

_tstmd 

code 

reloc 

int  _tstmd( ) } 

4036h 

19h 

strlen 

code 

reloc 

int  strlen!  )) 

5543h 

9h 

strchr 

code 

reloc 

unsigned  clar  *strchr(  )}5507h 

ch 

_stosgl 

code 

reloc 

int  _stosgl( )} 

7329h 

dh 

_shrull 

code 

reloc 

int  _shrulll )} 

57eah 

16h 

_shlull 

code 

reloc 

int  _shlulll )> 

59eah 

2ah 

_sgltos 

code 

reloc 

int  _sgltos( )} 

750  fh 

21h 

_addd 

code 

reloc 

int  _adddl )) 

4106h 

30h 

_ultoa 

code 

reloc 

unsigned  char  *_ultoa(  )}56e3h 

14h 

_ltod 

code 

reloc 

int  _ltod( )} 

3c9dh 

eh 

_ltos 

code 

reloc 

int  _ltos( (} 

3e45h 

eh 

_addul 

code 

reloc 

int  _addull )} 

64d5h 

37h 

_dblprec 

data 

reloc 

int  _dblprec } 

aOObh 

Oh 

_uprint 

code 

reloc 

int  _uprint<  )} 

2048h 

34h 

_cmpd 

code 

reloc 

int  _cmpdl ) } 

454bh 

79h 

_cmpl 

code 

reloc 

_cmpl 

6b35h 

dh 

_negd 

code 

reloc 

int  _negd( ) } 

4095H 

27h 

_negl 

code 

reloc 

_negl 

7allh 

ah 

_addull 

code 

reloc 

int  _addulll  )} 

Sbelh 

3eh 

_mulul 

code 

reloc 

int  _mulul( )> 

65cfh 

4l>h 

_mulll 

code 

reloc 

_mulll 

796dh 

18h 

_divd 

code 

reloc 

int  _divd( )} 

48d6h 

aeh 
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_dtol 

code 

reloc 

uctype 

const 

reloc 

_normd 

code 

reloc 

_nrmul 

code 

reloc 

_norms 

code 

reloc 

_ecvt 

code 

reloc 

_mulull 

code 

reloc 

_modsll 

code 

reloc 

_modull 

code 

reloc 

_mulwul 

code 

reloc 

_mulwsl 

code 

reloc 

_noduww 

code 

reloc 

_dtosl 

code 

reloc 

_dtoul 

code 

reloc 

_divul 

code 

reloc 

fputc 

code 

reloc 

_fcvt 

code 

reloc 

_nrmill 

code 

reloc 

_zerod 

code 

reloc 

_dbltoa 

code 

reloc 

_dbltod 

code 

reloc 

_dto<*»l 

code 

reloc 

_divulX 

code 

reloc 

_divlls 

code 

reloc 

_divwwu 

code 

reloc 

_divllu 

code 

reloc 

int  _dtol(  )j  3d4ah  24h 

unsigned  const  char  uctype<81hl i7b54h  Oh 


int  _normd( ) ) 

4aa4h 

eh 

int  _nrmult  )> 

bSb8h 

41h 

int  _norms<  H 

5181h 

eh 

unsigned  char  *_ 

_ecvt(  )  t Ibech 

2bh 

int  _mulull<  )> 

5elch 

Sah 

_modsll 

78e2h 

29h 

_modull 

788  2h 

ch 

_mulwul 

79a4h 

13h 

_mulwsl 

79clh 

lbh 

_moduww 

4a61h 

ch 

_dtosl 

3c66h 

24h 

_dtoul 

3c82h 

25h 

int  _divul( )j 

6a21h 

5dh 

int  fputct  ) ( 

7a38h 

lOh 

unsigned  char  * 

_fcvt<  )  >3c29h 

35h 

int  _nrmulll ) ^ 

Sd48h 

49h 

int  _zerod(  H 

405ch 

lfh 

unsigned  char  *_ 

.dbltoal ) >3718h 

16h 

int  _dbltod(  H 

6elch 

22h 

int  _dtodbll )» 

6b52h 

dh 

int  _divulll  H 

60S3h 

71h 

_divlls 

77f8h 

2ch 

_di vwwu 

lf8fh 

ch 

_divllu 

7795h 

ch 
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APPENDIX  C.  SOLAR  CELL  ARRAY  TEST  CIRCUIT  CODE 


A.  FILENAME  CELLTEST.C 


/*  May  28,  1988  Celltest.c 

Program  for  testing  solar  cell  array  I-V  characteristics  */ 


# include  "solareva.h" 
9 include  "newio.h" 

# include  "convert. h*1 
^include  "delay. h" 

Rdefine  ARRAYS2  1 
#define  STOP  0 
#define  START  3 


/*  number  of  test  cell  */ 

/*  stop  */ 

/*  high  assertion  for  two  bits  (convergence)  */ 


int  cellnum,  voltage,  cell,  row,  it 

char  voltdatat 

char  currentdatat 

char  cnvgncdone t 

float  voltoutt 

float  currentouti 

char  oldvoltt 

char  oldcurrenti 


void  execute) void ) t 
void  retrieve! void )  t 


struct  P0RT1_B  { 

unsigned  int  un: 
unsigned  int  strtcn: 
unsigned  int  celladd: 
)  command  =  (0,0,0) t 

struct  C_P0RT  ( 

unsigned  int  hi:  5* 

unsigned  int  bits:  2t 
unsigned  int  lo:  It 

)  *c_bitsi 

struct  data_pt  { 

char  voltagept) 
char  currentptt 
)  experiment_data[ 256  ]  [8  It 


/*PortB-l  Bit  field  */ 

3t  /*unused  bit*/ 

2t  /*a/d  start  conversion  signal*/ 

3)  /*solar  cell  number*/ 

/*  initialize  PortB_l  */ 

/*Bit  field  for  Port  C-2  input  */ 
/*unused  high  bits*/ 

/*bits  Cl  and  C2*/ 

/*unused  low  bits*/ 


/*Array  structure  for  data  storage*/ 
/•voltage*/ 

/•current*/ 

/*row/column  for  data*/ 


void  execute! void ) 


( 


I 

1 


4 


L 


4 


[4 


for  ( c«llnun=0 )  cellnum  <  ARRAYSZ !  cellnum++K 


/•loop  for  test  call*/ 


row=0 i 
oldvolt=0> 
oldcurrent=0 ! 

command. celladd=cellnum! 
output! PORT 1_CTRL,  command)! 

for  (voltage=0!  voltage  <  256 !  voltage++ 
output! P0RT1_0A,  voltage)! 

command. strtcn=START  \ 

output! P0RT1_CTRL»  command)! 

command. strtcn=STOP ! 

output! P0RT1_CTRL>  command)! 

delay! 1 ) ! 

while  ( TRUE  K 


/•storage  counter*/ 

/•initialize  comparison  variable*/ 
/•initialize  comparison  variable*/ 

/•set  address  bits«/ 

/•initialize  PortB-1*/ 

K  /*input  voltage  ladder*/ 

/•output  cell  bias  voltage*/ 

/•Start  Convergence  pulse*/ 

/•for  both  ADC's*/ 

/•do  it«/ 

/•End  Start  Convergence*/ 

/•pulse  for  both  ADC's*/ 

/•do  it*/ 

/*1  ms  delay  for  settling#/ 

/•EOC  check  loop*/ 


cnvgncdone  =  input! P0RTC2  ) ! 
c_bits  =  I  struct  C_PORT  #  )  l Scnvgncdone ) ! 
if  ( c_bits->bits==0x03 ! 
break! 


/•assign  P0RTC2  word*/ 

/•looking  for  EOC  bits#/ 

/•bits  Cl  and  C2  must  be  high*/ 
/•When  EOC  bits  high,  cont.#/ 


voltdata  =  input! PORT 2_ADV)»  /*collect  voltage  info#/ 

currentdata  =  input! PORT 2_ADC ) 1  /«collect  current  info*/ 


if! (voltdata  ==  oldvolt )  it  (currentdata  ==  oldcurrent ) ) 


continue! 


if ( oldvolt  !  =  OK 
if! oldvolt  <  voltdata) 
continue! 

) 

oldvolt=voltdata ! 
oldcurrent=cur rent data ! 

if! voltdata  ==  0) 
voltage  ■  255! 


/•ignore  transistor  bias*/ 
/•and  multiple  data*/ 

/•smooth  curve,  delete*/ 
/•voltage  surges*/ 


/•reset  comparison#/ 
/•reset  comparison*/ 

/•I sc  reached*/ 
/•end  loop*/ 


/#  Data  Storage  */ 

experiment_data( row ][ cellnum] . voltagept  =  voltdata! 

/•stores  voltage  data*/ 

experiment_data(  rowHcellnum  ]  .currentpt  =  currentdata! 

/•stores  current  data#/ 

row++!  /« increment  array  row*/ 
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4 


) 

voltage=0) 

output!  PORH_DA  >  voltage  )  i 


/•turn  oft  bias*/ 
/•do  it*/ 


) 

/*******************»»******»*************************************************/ 
/*  routine  to  retreive  data  from  RAM  */ 

void  retrieve! void) 

{ 

printf! “Specify  cell  number)  0-7.  " )l  /*Hhich  cell  data?*/ 

cell  =  getintl  )>  /*get  cell  number  from  terminal*/ 

printf!  "  n,r"  )  ) 


printf!  "Zd»/!d,n  r"  ,2,2 )  ) 


/•disc  file  output  header*/ 


for  (i=0)  i<256  S3  (  (  experiment_datat  i  Hcell  ] .  voltagept  !=  0) 

( experimant_datat i H call ] .currentpt  !=  0)))  ++i  K 

/•loop  prevents  collecting  data  past  end  of  file*/ 


voltout  =  ( float  )experiment_data[ i It  cell  1 .voltagept  *  .0041) 

/•floating  decimal  at  .0041  mv  per  step*/ 
currentout  =  (  float  )experiment_datat  i  Hcell  ]. currentpt  *  .00117) 

/•floating  decimal  at  .0117  mv  per  step  and*/ 
/•division  by  9.9  ohms  to  current*/ 


printf! "Xf>",  voltout)) 
printf ( "Zf»" ,  currentout)) 
printf I "Xf n  r" ,  0.0)  y 

} 

printf! "Zd.Xd ,Zd" ,30 ,20 ,30  ) ) 

) 


/•output  voltage*/ 

/•output  current*/ 

/•disk  file  trailer*/ 

/•disk  file  end  parameters*/ 


APPENDIX  D.  SAMPLE  SILICON  SOLAR  CELL  TEST  DATA 
A.  FILENAME  SILICON.DAT 
2,2 

0 . 524800,0. 000000,0.000000 
0 . 524800,0. 001170,0. 000000 
0.524800,0. 002340,0. 000000 
0.524800,0. 003510,0. 000000 
0 . 524800,0. 004680,0 . 000000 
0 . 524800 , 0 . 005850 , 0 . 000000 
0.524800,0. 007020,0. 000000 
0.524800,0.008190,0.000000 
0.524800,0. 009360,0. 000000 
0 . 524800,0. 010530,0. 000000 
0 . 524800,0.011700,0. 000000 
0 . 524800 , 0 . 012870,0. 000000 
0 . 524800 ,0 . 014040,0. 000000 
0 . 524800,0. 015210,0. 000000 
0 . 524800 ,0.016380,0. 000000 
0 . 524800,0. 017550 , 0 . 000000 
0 . 524800 ,0 . 018720,0. 000000 
0 . 524800,0.019890,0. 000000 
0 . 524800 , 0 . 021060 , 0 . 000000 
0 . 524800,0. 022230,0. 000000 
0.524800,0.023400,0.000000 
0 . 524800,0. 024570 ,0 . 000000 
0 . 524800 ,0.025740,0. 000000 
0 . 524800 ,0 . 026910,0. 000000 
0 . 524800,0. 028080 , 0 . 000000 
0 . 524800,0.029250,0. 000000 
0 . 524800,0. 030420 , 0 . 000000 
0 . 524800,0. 031590,0. 000000 
0 . 524800,0. 032760,0. 000000 
0.520700,0.033930,0.000000 
0.520700,0. 035100,0. 000000 
0.520700,0.036270,0.000000 
0 . 516600,0. 037440,0. 000000 
0 . 516600 , 0 . 038610 ,0 . 000000 
0.512500,0. 039780,0. 000000 
0 . 512500,0. 040950 ,0 . 000000 
0.512500,0. 042120,0. 000000 
0 . 508400,0. 043290,0. 000000 
0 . 508400,0. 044460,0. 000000 
0 . 508400 ,0 . 045630 ,0 . 000000 
0.504300,0. 046800 ,0 . 000000 
0 . 504300 ,0 . 047970 ,0 . 000000 
0 . 504300,0. 049140 ,0 . 000000 
0 . 500200,0. 050310 ,0 . 000000 
0 . 500200 ,0 . 051480 ,0 . 000000 
0 . 500200,0. 052650,0. 000000 
0.496100,0.053820,0.000000 
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0.496100,0. 054990 , 0 . 000000 
0.492000,0.056160,0.000000 
0 . 492000,0. 057350,0. 000000 
0.492000,0.058500,0.000000 
0 . 487900,0. 059670 ,0 . 000000 
0 . 487900,0. 060840,0. 000000 
0.487900,0.062010,0.000000 
0 . 485800,0. 063180 ,0 . 000000 
0.483800,0. 064350,0. 000000 
0 . 483800,0. 065520 ,0 . 000000 
0 . 479700,0. 066690,0. 000000 
0.479700,0.067860,0.000000 
0 . 475600 , 0 . 069030,0. 000000 
0.475600,0.070200,0.000000 
0.475600,0.071370,0.000000 
0 . 471500 , 0 . 072540,0. 000000 
0.471500 ,0.073710,0. 000000 
0.467400,0.074880,0.000000 
0.467400,0.076050,0.000000 
0.467400,0.077220,0.000000 
0.463300,0.078390,0.000000 
0.463300,0.079560,0.000000 
0.463300,0.080730,0.000000 
0.455100,0. 081900,0. 000000 
0 . 455100 , 0 . 084240,0. 000000 
0 . 451000,0. 085410,0. 000000 
0.451000 ,0.086580,0.000000 
0 . 451000,0. 087750,0. 000000 
0 . 446500 ,0 . 088920,0. 000000 
0.446900,0.090090,0.000000 
0.442800,0.091260,0.000000 
0.438700,0.092430,0.000000 
0.438700,0.094770,0.000000 
0 . 434600 ,0 . 095940,0. 000000 
0.  '^30500, 0.098280, 0.000000 
0.430500,0.099450,0.000000 
0.430500,0.100620,0.000000 
0.422300,0. 101790,0. 000000 
0.422300,0.102960,0.000000 
0.422300,0.104130,0.000000 
0.414100,0. 105300 ,0 . 000000 
0.414100,0. 107640,0.000000 
0.405900,0.108810,0.000000 
0.357700,0.112320,0. 000000 
0 . 385400,0. 115830,0. 000000 
0.377200,0.119340,0.000000 
0 . 360800,0. 122850,0. 000000 
0 . 336200,0. 126360,0. 000000 
0.295200,0.129870,0.000000 
0 . 028700,0. 131040,0. 000000 
0 . 000000,0. 132210,0. 000000 
30,30,30 
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